Guía del usuario de MedWand Telemedicine API V2.x

Guía del usuario de MedWand Telemedicine API V2.x


Bienvenido

Bienvenido a MedWand Telemedicine Versión 2.x

MedWand ofrece un conjunto de recursos API preconstruidos que puede utilizar para integrar la plataforma MedWand VirtualCare con su sistema actual. Aprovechando nuestros recursos API preconstruidos, puedes ir al suelo corriendo a tu propio ritmo. Si descubre que nuestros recursos API preconstruidos no se ajustan a sus necesidades, podemos trabajar con usted para crear un conjunto personalizado de endpoints.

¿Por qué mi "patientUrl" no funciona como se esperaba?

El "patientUrl" es único en que funciona de manera muy diferente al "doctorUrl" y "guestUrl". Mientras que los "doctorUrl" y "guestUrl" son URL típicas a las que se pueden navegar a través de una etiqueta de anclaje, JavaScript, pegado en la barra de direcciones del navegador, o ejecutarse desde una aplicación compilada.
El "patientUrl" solo se puede navegar a través de una etiqueta de anclaje del usuario, JavaScript, o ejecutarse desde una aplicación compilada.
Esto también debe estar en el dispositivo móvil que está conectado al dispositivo de hardware MedWand y tiene instalada la aplicación MedWand VirtualCare Android Client.

El "patientUrl", cuando navega a través de uno de los métodos descritos anteriormente, será interceptado por el sistema operativo Android y abrirá automáticamente la aplicación MedWand VirtualCare Client a través de un URI interno, para comenzar el examen. Debido a las limitaciones de los navegadores en dispositivos móviles, un navegador no inicia una aplicación externa para un determinado URI Intent en los siguientes casos.

  • Cuando el URI objetivo es redirigido desde una URL escrita.
  • Cuando el URI objetivo se inicia sin gesto de usuario.

Debido a esta razón, el "patientUrl" solo se puede utilizar a través de uno de los métodos descritos anteriormente. Si intenta usar el "patientUrl" de cualquier otra manera, se le enviará a una página en el navegador indicando: "Este tipo de examen debe ejecutarse desde la tableta MedWand".

Configuración

Configuración

Esta información es necesaria antes de que podamos emitirle a usted y API Token. Una vez que tenga esta información, puede solicitar su API Token en la pestaña 'Comenzar'.
Callback URL

La URL de devolución de llamada para su api. Este es el URI al que desea que se envíen los resultados del examen después de que se complete el examen.

Tipo de Callback

Hay 4 opciones para recibir información del examen.

  1. Ninguno:

    Usted no recibirá notificación al finalizar el examen. Esta opción es buena para sistemas en los que solo utiliza MedWand VirtualCare System y no almacena los resultados.

  2. Completo:

    Recibirás un objeto json que contiene el examen completo en formato Json a la CallbackUrl que proporcione.

  3. Html:

    Recibirás un objeto json que contiene el examen completo en formato html al CallbackUrl que proporcione.

Tipo de autenticación de llamada

Hay 4 opciones para autenticar nuestro callback a su api.

  1. Ninguno:

    No se necesita ningún encabezado de autorización o propiedades.

  2. KeySecret:

    La clave y el secreto proporcionados se agregan a la cabecera a través de los pares de teclas "key" y "secreto".

  3. Bearer:

    El Token proporcionado se agregará al encabezado a través de la clave "Autorización" con el valor precedido con "Bearer".

  4. ApiToken:

    El Token proporcionado se agregará al encabezado a través de la clave "ApiToken".

  5. Custom:

    El token proporcionado se agregará al encabezado a través de su clave personalizada.

Valor de autorización de Callback

El valor de autorización URL de devolución de llamada que se utilizará junto con el Tipo de Autenticación de Callback elegido.

Empezar

Empezar

La información de la pestaña "Configuración" es necesaria antes de que podamos emitir su API Token. Una vez que tenga esta información, puede solicitar su API Token.
Paso 1: Solicite su token API de Sandbox

Para empezar, debes solicitar una cuenta Sandbox para tu empresa. Esto se hace a través de su vendedor.

Una vez que tengas tu cuenta Sandbox:

  1. Solicite su API Token para comenzar a probar haciendo clic en el enlace de abajo para solicitar sus claves.
  2. Luego nos pondremos en contacto con usted para solicitar cualquier información adicional necesaria en la sección "Configuración". Por favor, no proporcione esta información en el formulario de solicitud de claves api.
  3. Su cuenta se actualizará y su API Token se enviará directamente a su contacto técnico.
Solicitar una clave API-Revise la sección de configuración antes de solicitar su clave API. Se le pedirá que proporcione su configuración de configuración dentro de la solicitud de ticket de soporte antes de que se pueda generar la clave API.
Paso 2: Herramientas de prueba API

MedWand recomienda y utiliza Postman o Insomnio para todas las pruebas API. El insomnio es más capaz de manejar grandes peticiones y respuestas que pueden ser el caso con algunos resultados de los exámenes. Aunque usted puede utilizar cualquier herramienta que desee, el uso de Insomnio nos permitirá ayudarle mejor si surge la necesidad. Puedes descargar e instalar Insomnia desdeAquí.

Paso 3: Primera prueba

Su primera prueba será recuperar una respuesta de los latidos del corazón del servidor api. Para ello siga estos pasos:

cUrl

curl --location 'https://api.medwand.cloud/heartbeat'

Postman

  1. Añadir una nueva solicitud en Postman.
  2. Seleccione "GET" como el tipo de método.
  3. Entrar "https://api.medwand.cloud/heartbeat"como la URL.
  4. En la pestaña "Autorización", establezca el tipo en "No Auth".
  5. Haga clic en el botón "Enviar".

Respuesta

{
"actionResult": verdad,
"actionResponse": "Éxito",
"actionMensajes": "Versión: 2,0.6,104 Construcción: 2026,3.12,246",
"actionDateUtc": "2026-03-18T21:31:39,835353597Z",
"ambiente": "Sandbox"
}
Flowchart

Flowchart

El diagrama de flujo a continuación cubre los 3 tipos de examen (Paciente, OnSite y Remote) que puede usar.

Una vez que tenga una buena comprensión del flujo, estará listo para comenzar a usar nuestra API predeterminada para integrar el sistema de atención virtual MedWand con su plataforma PMS/EHR existente.


Nombramientos

Nombramientos

POST: Crea tu cita.

cUrl SolicitudTendrá que insertar su ApiToken en el encabezado de abajo o la solicitud fallará como 'No autorizado'.


curl --location 'https://api.medwand.cloud/default/v2/appointment/create'\
--header 'Content-Type: application/json' \
--header 'ApiToken: ' \
--data '{
"nombramientoId": "985397aa-558b-456c-8c57-00dfd5af9b56",
"doctorNombre": "Dr. Jane Clinician",
Nombre del paciente: John Doe
"examType": "OnSite",
"scheduledStartDateUtc": "2026-03-19T15:51:49,780Z",
"scheduledDuration": 30
}'

Respuesta


{
"nombramientoId": "985397aa-558b-456c-8c57-00dfd5af9b56",
"patientUrl": "https://api.medwand.cloud?platform=api.medwand.cloud&token=GFXwMZiRTka6jVlq_zNhOQ",
"doctorUrl": "",
"guestUrl": "",
"actionResult": verdad,
"actionResponse": "Éxito",
"actionMensajes": "",
"actionDateUtc": "2026-03-19T15:51:49,780Z",
"ambiente": "Sandbox"
}
POST: Actualiza tu cita.

cUrl SolicitudTendrá que insertar su ApiToken en el encabezado de abajo o la solicitud fallará como 'No autorizado'.


curl --location 'https://api.medwand.cloud/default/v2/appointment/update'\
--header 'Content-Type: application/json' \
--header 'ApiToken: ' \
--data '{
"nombramientoId": "985397aa-558b-456c-8c57-00dfd5af9b56",
DoctorNombre: Dr. Jane Fox.
"Nombre del paciente": "Robert Doe",
"examType": "Remote",
"scheduledStartDateUtc": "2026-03-19T15:51:49,780Z",
"scheduledDuration": 30
}'

Respuesta


{
"nombramientoId": "985397aa-558b-456c-8c57-00dfd5af9b56",
"patientUrl": "https://client.medwand.cloud?platform=api.medwand.cloud&token=GFXwMZiRTka6jVlq_zNhOQ",
"doctorUrl": "https://examroom.medwand.cloud?platform=api.medwand.cloud&token=hkzBXDrXW0KH04ByCdxK-w",
"guestUrl": "https://examroom.medwand.cloud/Guest?platform=api.medwand.cloud&token=bz09_6hmXUWIyRy2sHK4bg",
"actionResult": verdad,
"actionResponse": "Éxito",
"actionMensajes": "",
"actionDateUtc": "2026-03-19T15:51:49,780Z",
"ambiente": "Sandbox"
}
POST: Eliminar su cita.

cUrl SolicitudTendrá que insertar su ApiToken en el encabezado de abajo o la solicitud fallará como 'No autorizado'.


curl --location 'https://api.medwand.cloud/default/v2/appointment/delete'\
--header 'Content-Type: application/json' \
--header 'ApiToken: ' \
--data '{
"nombramientoId": "985397aa-558b-456c-8c57-00dfd5af9b56"
}'

Respuesta


{
"actionResult": verdad,
"actionResponse": "Éxito",
"actionMensajes": "",
"actionDateUtc": "2026-03-19T15:51:49,780Z",
"ambiente": "Sandbox"
}
Resultados del examen

Resultados del examen

Completo:Recibirás un objeto json que contiene los resultados completos del examen.
  • appointmentId: ¿Es la citaId que proporcionó cuando solicitó una cita.
  • doctorName: El nombre del médico que proporcionó cuando solicitó una cita.
  • PatientName: El nombre del nombre del paciente que proporcionó cuando solicitó una cita.
  • ExamenType: Hay 3 tipos de examen (Paciente, OnSite, Remote) y son sensibles a los casos.
  • doctorEnterDateUtc: La fecha / hora UTC en que el médico entró en el examen.
  • patientEnterDateUtc: La fecha / hora UTC en que el paciente ingresó al examen.
  • startDateUtc: La fecha / hora UTC en que se inició el examen.
  • endDateUtc: La fecha / hora UTC en que se completó el examen.
  • durationInMinutesDuración del examen en minutos.
  • PractitionerNotes: Notas introducidas por el médico.
  • PatientNotesNotas introducidas por la enfermera/paciente.
  • HTMLDocumento: Una representación Html (sin javascript) de los resultados del examen. VerEjemplo de documento HTML
  • lecturas: Array de
    • sortOrderEl orden en que se tomó la lectura.
    • deviceName: El nombre formal del dispositivo utilizado para tomar la lectura.
    • DispositivoModelo: El nombre del modelo del dispositivo utilizado para tomar la lectura.
    • deviceSerial: El número de serie del dispositivo utilizado para tomar la lectura.
    • deviceFirmware: La versión de firmware del dispositivo utilizado para tomar la lectura.
    • sensorEl nombre formal del sensor.
    • sensorId: El id del dispositivo utilizado para tomar la lectura.
    • sensorMode: El modo en el que estaba el sensor durante la lectura.
    • sensorSettings: La configuración aplicada a los datos del sensor.
    • sensorData: El resultado de la lectura del sensor.

{
"nombramientoId": "3e42582f-d2e5-45f6-a0cb-81a61e430f42",
"doctorNombre": "Dr. Charlotte Myers",
"Nombre del paciente": "Elijah Reynolds",
"examType": "Remote",
"doctorEnterDateUtc": "2025-01-23T15:47:54,1365002",
"patientEnterDateUtc": "2025-01-23T15:48:54,2080408",
"startDateUtc": "2025-01-23T15:48:54,2080408",
"endDateUtc": "2025-01-23T15:57:56,346181",
"durationInMinutes": "9",
"PractitionerNotes": "Estos son Notas de Practitioner Notes línea 1\nEstas son Notas de Practitioner línea 2\nEstas son Notes Practitioner línea 3",
"Notas de paciente": "Estos son Notas de paciente línea 1\nEstas son Notas de Paciente línea 2\nEstas son Notas de Paciente línea 3",
"htmlDocument": "",
"lecturas":
[
{
"SortOrder": 1,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Otoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Dermatoscopio",
"sensorSettings": "",
"sensorData": "datos:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 2,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Ecg",
"sensorId": "11)2103260000006A",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "datos:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAN/oAAAI5CAYAAACJX..."
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "Sangre Pressure",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "120/80"
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "LabNotes",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "esta es la línea de notas de laboratorio 1\nthis es la línea de notas de laboratorio 2"
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "GTTInitial",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "100"
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "HeightScale",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "unit:Inches",
"sensorData": "65,0"
},
{
"SortOrder": 1,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "PulseRate",
"sensorId": "11)2103260000006A",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "101"
},
{
"SortOrder": 3,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Otoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Dermatoscopio",
"sensorSettings": "",
"sensorData": "datos:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "CholesterolHdl",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "400"
},
{
"SortOrder": 4,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Estetoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Lungs",
"sensorSettings": "",
"sensorDatos": "datos:audio/mp3;base64,SUQzBAAAAAAAAAIlRTU0UAAOAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 1,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Thermómetro",
"sensorId": "11)2103260000006A",
"sensorMode": "Default",
"sensorSettings": "unit:Fahrenheit",
"sensorData": "97,2"
},
{
"SortOrder": 6,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Otoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Otoscopio",
"sensorSettings": "",
"sensorData": "datos:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 1,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Ecg",
"sensorId": "11)2103260000006A",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "datos:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAN+4AAAI5CAYAAACnG..."
},
{
"SortOrder": 3,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Estetoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Lungs",
"sensorSettings": "ubicación:UpperMidLeftThorax",
"sensorDatos": "datos:audio/mp3;base64,SUQzBAAAAAAAAAIlRTU0UAAOAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "Respiratorio",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "25,0"
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "PainLevel",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "unit:Numerical",
"sensorData": "2"
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "GTT2Hour",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "300"
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "SpirometerFev1",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "22,0"
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "WaistSize",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "unit:Inches",
"sensorData": "45,0"
},
{
"SortOrder": 1,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Estetoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Corazón",
"sensorSettings": "",
"sensorDatos": "datos:audio/mp3;base64,SUQzBAAAAAAAAAIlRTU0UAAOAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "Glucómetro",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "150"
},
{
"SortOrder": 2,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Estetoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Corazón",
"sensorSettings": "",
"sensorDatos": "datos:audio/mp3;base64,SUQzBAAAAAAAAAIlRTU0UAAOAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "Escala de peso",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "unit:Pounds",
"sensorData": "200,0"
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "ColesterolTotal",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "600"
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "CholesterolLdl",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "500"
},
{
"SortOrder": 5,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Estetoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Abdominal",
"sensorSettings": "",
"sensorDatos": "datos:audio/mp3;base64,SUQzBAAAAAAAAAIlRTU0UAAOAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 2,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Otoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Dermatoscopio",
"sensorSettings": "",
"sensorData": "datos:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 4,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Otoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Otoscopio",
"sensorSettings": "",
"sensorData": "datos:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "GTT1Hour",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "200"
},
{
"SortOrder": 6,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Estetoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Abdominal",
"sensorSettings": "",
"sensorDatos": "datos:audio/mp3;base64,SUQzBAAAAAAAAAIlRTU0UAAOAAADTGF2ZjYwLjMuM..."
},
{
"SortOrder": 7,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Estetoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Abdominal",
"sensorSettings": "skip:UpperMidLeftThorax: No pude tomar esta grabación debido a un problema que encontré mientras intentaba tomar la grabación. Esta es una larga razón para no tomar la grabación."
"sensorData": "-"
},
{
"SortOrder": 1,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "SpO2",
"sensorId": "11)2103260000006A",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "94"
},
{
"SortOrder": 5,
"dispositivoName": "Dispositivo MedWand",
"deviceModelo": "Generation2",
"dispositivoSerial": "(01)00860004311607(11)210326(21)0000006A",
"deviceFirmware": "2,1.0,2",
"sensor": "Otoscopio",
"sensorId": "11)2103260000006A",
"sensorMode": "Otoscopio",
"sensorSettings": "",
"sensorData": "datos:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/4gHYSUNDX1BS..."
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "SpirometerPef",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "11"
},
{
"SortOrder": 1,
"deviceName": "Entrada manual",
"deviceModel": "--",
"deviceSerial": "MedWand App",
"deviceFirmware": "--",
"sensor": "SpirometerFvc",
"sensorId": "--",
"sensorMode": "Default",
"sensorSettings": "",
"sensorData": "33,0"
}
],
"actionResult": verdad,
"actionResponse": "Éxito",
"actionMensajes": "",
"actionDateUtc": "2025-01-23T17:58:39,0298659Z",
"ambiente": "Sandbox"
}
Html:Recibirás un objeto json que contiene el examen completo en formato Html.
  • appointmentId: ¿Es la citaId que proporcionó cuando solicitó una cita.
  • HTMLDocumento: Una representación Html (sin javascript) de los resultados del examen. VerEjemplo de documento HTML

{
"nombramientoId": "985397aa-558b-456c-8c57-00dfd5af9b56",
"htmlDocument": "...",
"actionResult": verdad,
"actionResponse": "Éxito",
"actionMensajes": "",
"actionDateUtc": "2026-03-19T15:51:49,780Z",
"ambiente": "Sandbox"
}
(Deprecated)Notificar:Recibirás un simple objeto json para el CallbackUrl que proporcione.
Warning
El tipo de devolución de llamada "Notify" ha sido obsoleto y ya no es compatible.

El objeto JSON a continuación es lo que se envía a la URL Callback que proporciona.

  • ExamenId: ¿Es la citaId que proporcionó cuando solicitó una cita.
  • endDate: La fecha / hora UTC en que se completó el examen.
{
examenId = "985397aa-558b-456c-8c57-00dfd5af9b56",
endDate = "2026-03-19T15:51:49,780Z"
}

A continuación, tendrá que recuperar los resultados del examen a través de 1 de los siguientes puntos finales.

POST: Recuperar los resultados completos del examen.

cUrl SolicitudTendrá que insertar su ApiToken en el encabezado de abajo o la solicitud fallará como 'No autorizado'. Si configura la propiedad includeHtml en true, la respuesta incluirá una versión Html de los resultados del examen en la propiedad htmlDocument.


curl --location 'https://api.medwand.cloud/default/v2/exam/results'\
--header 'Content-Type: application/json' \
--header 'ApiToken: ' \
--data '{
"nombramientoId": "985397aa-558b-456c-8c57-00dfd5af9b56",
"includeHtml": false
}'

Respuesta

Ver la respuesta completa abajo.

POST: Recuperar los resultados del examen html.

cUrl SolicitudTendrá que insertar su ApiToken en el encabezado de abajo o la solicitud fallará como 'No autorizado'.


curl --location 'https://api.medwand.cloud/default/v2/exam/html'\
--header 'Content-Type: application/json' \
--header 'ApiToken: ' \
--data '{
"nombramientoId": "985397aa-558b-456c-8c57-00dfd5af9b56"
}'

Respuesta

Vea la respuesta Html a continuación.

Recuperación fallida

Información de recuperación de fallos

Notificación

Se enviará un correo electrónico al equipo de MedWand y a los contactos técnicos de su cuenta.

Conservaremos los resultados de su examen durante 30 días para que pueda recuperarlos después de que ocurra un fracaso. Puede eliminar los resultados del examen a través de una llamada api en cualquier momento.

Estamos enfocados en proporcionar un sistema de reintento automatizado que no afectará nuestra capacidad de respuesta actual de API.

Solicite una lista de resultados del examen disponibles


curl --location 'https://api.medwand.cloud/default/v2/exam/list'\
--header 'Content-Type: application/json' \
--header 'ApiToken: ' \

Solicitar un resultado específico del examen


curl --location 'https://api.medwand.cloud/default/v2/exam/results'\
--header 'Content-Type: application/json' \
--header 'ApiToken: ' \
--data '{
"appointmentId": "[APPOINTMENTID]",
"includeHtml": false
}'

Reenviar un resultado específico del examen a su CallbackUrl


curl --location 'https://api.medwand.cloud/default/v2/exam/callback/resend'\
--header 'Content-Type: application/json' \
--header 'ApiToken: ' \
--data '{
"appointmentId": "[APPOINTMENTID]"
}'

Eliminar un resultado específico de examen de nuestro sistema


curl --location 'https://api.medwand.cloud/default/v2/exam/results/remove'\
--header 'Content-Type: application/json' \
--header 'ApiToken: ' \
--data '{
"appointmentId": "[APPOINTMENTID]"
}'
Información técnica

Información técnica

Json Casing

Para aquellos sistemas donde el caso Json importa.

  • Todas las solicitudes que hagas a nuestro api pueden estar en cualquier carcasa que desee, ya que aceptamos todos los formatos.
    • Caso de camello - por ejemplo firstName
    • Caso Pascal - por ejemplo FirstName
    • Caso superior - por ejemplo FIRSTNAME
    • Lower case - por ejemplo primername
  • Todas las respuestas de nosotros a sus solicitudes serán en el caso Camel.
    • Caso de camello - por ejemplo firstName
  • Todas las devoluciones de llamadas salientes de nuestro sistema de devolución de llamada a su api serán en caso Pascal.
    • Caso Pascal - por ejemplo FirstName
  • Todos los archivos json en modo offline estarán en el caso Camel. Todos los archivos json en modo offline estarán en el caso Camel.
    • Caso de camello - por ejemplo firstName

Tipos de examen

Estos valores son sensibles a casos

  • paciente: Este es un autoexamen completado por el paciente solamente.
  • OnSite: Este es un examen local completado por un profesional (enfermera, médico, etc.).
  • Remote: Este es un examen completado por un profesional (enfermera, médico, etc.)desde una ubicación remota.

Tipos de sensores

Estos son los tipos de sensores disponibles junto con sus posibles tipos de unidades.

  • Termómetro: El campo de configuración indica el tipo de unidad.
    • Unidad: Fahrenheit
    • Unidad: Celsius
  • SpO2:
  • PulseRate:
  • presión arterial:
  • Escala de peso: El campo de configuración indica el tipo de unidad.
    • Unidad: libras
    • Unidad: Kilogramos
  • HeightScale: El campo de configuración indica el tipo de unidad.
    • Unidad: Pulgadas
    • Unidad: centímetros
  • Glucómetro:
  • Respiratorio:
  • SpirometerPef:
  • SpirometerFev1:
  • SpirometerFvc:
  • Nivel de dolor: El campo de configuración indica el tipo de unidad.
    • Unidad: Numérico
    • Unidad: PAINAD
  • Tamaño de la cintura: El campo de configuración indica el tipo de unidad.
    • Unidad: Pulgadas
    • Unidad: centímetros
  • GTTInitialLectura inicial de glucosa en sangre después del ayuno
  • GTT1HourLectura de glucosa en sangre después de 1 hora
  • GTT2HourLectura de glucosa en sangre después de 2 horas
  • GTT3HourLectura de glucosa en sangre después de 3 horas
  • ColesterolHdl:
  • ColesterolLdl:
  • ColesterolTotal:
  • LabNotes: Este es texto plano de un campo de nota.

Tipos de medios

Estos son los tipos de medios disponibles junto con sus posibles modos y configuraciones.

  • Estetoscopio: El campo sensorMode indica el modo en el que estuvo el sensor durante la lectura. Se puede encontrar información más detalladaAquí.
    • Corazón
      • Ubicación:UpperLeftThorax
      • Ubicación:UpperRightThorax
      • Ubicación:CenterThorax
      • Ubicación:LowerLeftThorax
    • Pulmones
      • Ubicación:UpperMidLeftThorax
      • Ubicación:UpperMidRightThorax
      • Ubicación:LowerOuterLeftThorax
      • Ubicación:LowerOuterRightThorax
      • Ubicación:LowerSideLeftThorax
      • Ubicación:LowerSideRightThorax
    • Abdominal
      • Ubicación:UpperRightAbdomen
      • Ubicación:UpperLeftAbdomen
      • Ubicación:LowerLeftAbdomen
      • Ubicación:LowerRightAbdomen
  • Otoscopio: El campo sensorMode indica el modo en el que estuvo el sensor durante la lectura.
    • Dermatoscopio
    • Otoscopio
  • Ecg
  • QTMedical

Si desea un ejemplo de cómo puede mostrar los resultados del examen, haga clic en estoResultados del examen HTML MuestraLink.

Faq
Preguntas frecuentes

¿Qué es MedWand Telemedicine Cloud?

Telemedicine Cloud de MedWand consiste en los servidores y bases de datos necesarios para intercambiar datos entre MedWand y su sistema EHR. También es compatible con el examen remoto de telemedicina.

¿Cuánto tiempo tarda una implementación con la API predeterminada de MedWand?

Varía de cliente a cliente según sus recursos de desarrollador. Muchos de nuestros clientes han completado una implementación de API en tan solo unos días o semanas.

¿Cuáles son algunas de las configuraciones sugeridas del servidor para mi endpoint callback?

Varía de cliente a cliente según el servidor, los sistemas operativos y los tipos/tamaños de exámenes que se realice. Aquí estánAlgunos ejemplosConfiguración sugerida del servidor.

¿MedWand soporta implementaciones API personalizadas o basadas en FHIR en lugar de JSON?

¡Sí! Podemos dar soporte a API FHIR específicas de los clientes, pero muchos clientes han encontrado que un enfoque más simple de API JSON era más apropiado. Su equipo de ventas de MedWand organizará una reunión con nuestros ingenieros para satisfacer sus requisitos específicos de FHIR.

¿Hay costos adicionales para las implementaciones personalizadas o FHIR API?

¡Posiblemente! Su equipo de ventas de MedWand proporcionará orientación específica y / o discusiones de precios.

¿Se puede implementar MedWand si tenemos nuestra propia aplicación en el dispositivo móvil?

¡Sí! MedWand realizó muchas implementaciones con clientes utilizando su propia aplicación móvil. Nuestro equipo de ventas de MedWand proporcionará orientación específica y/o discusiones con el equipo de Ingeniería de MedWand.

¿Qué datos PHI almacena MedWand Telemedicine Cloud?

MedWand solo almacena algunas piezas de datos de PHI para una próxima cita:

  1. Los nombres del médico/paciente son opcionales, pero permiten una mejor experiencia de usuario.
  2. Opcionalmente, si se necesita integración de IA, la edad, sexo y peso del paciente permiten una funcionalidad de IA más precisa.

Después de que los datos del examen estén en su sistema EHR, MedWand eliminará los datos del examen y toda la PHI de nuestros sistemas.

¿Podemos abrir el DoctorUrl/GuestUrl dentro de un iFrame?

No podemos permitir que nuestro DoctorUrl/GuestUrl sea incrame. Esto nos pondría en violación de nuestro cumplimiento de SOC 2.

Puede abrir cualquiera de estos como en la pestaña actual o en una nueva pestaña/ventana.

Nombramientos

¿Qué tipos de citas son compatibles?

Apoyamos 3 tipos de cita:

  • Remote: Permite un examen remoto de telemedicina médico/paciente.
  • OnSite: Permite una visita in situ que no requiere un médico remoto.
  • Paciente: Permite un autoexamen por parte del paciente según lo solicitado o prescrito por un médico.

¿Por qué necesitas el nombre del médico y del paciente?

Los nombres del médico/paciente son opcionales, pero permiten una experiencia de usuario más personalizada y amigable.

¿Por qué necesita la edad, sexo y peso del paciente?

La edad, sexo y peso del paciente permiten una funcionalidad de IA más precisa. Esta información es opcional. Las integraciones de IA son personalizadas y pueden ser explicadas por su equipo de ventas de MedWand.

¿Cómo se nos notifica cuando se ha completado una cita?

MedWand realizará una llamada api al punto final api especificado en función de las opciones de configuración seleccionadas.

Datos de examen

¿Cómo recuperamos los datos del examen para una cita completada?

Puede recuperar o recibirán los datos del examen después de que se haya completado el examen basándose en las opciones de configuración seleccionadas.

¿Qué formatos son compatibles para grabaciones de estetoscopio?

Actualmente soportamos datos base64/mp3. Si se requiere información adicional de estetoscopio para los tipos de integración de IA, comuníquese con su equipo de ventas de MedWand.

¿Qué formatos son compatibles con las capturas de otoscopios?

Actualmente soportamos datos base64/jpeg. Si se requiere información adicional del otoscopio para los tipos de integración de IA, póngase en contacto con su equipo de ventas de MedWand.

¿Qué formatos son compatibles con las capturas ecg?

Actualmente soportamos datos base64/jpeg. Si se requiere información adicional de ECG para los tipos de integración de IA, comuníquese con su equipo de ventas de MedWand.



    • Related Articles

    • Guía de referencia post-entrenamiento

      A continuación se muestra una guía de referencia para el post-entrenamiento para un acceso rápido al material de ayuda relevante: Acceso a exámenes Pacientes y facilitadoresNo deberíaabra directamente la aplicación MedWand para comenzar un examen ...

    • Información general de MedWand VirtualCare API

      Plataforma de examen MedWand VirtualCare MedWand VirtualCare Examination Platform está diseñada para actuar como un módulo plug-in para su software existente PMS/HIS/EHR, también conocido como un módulo de plug-in para su software existente ...

    • Servicios para desarrolladores de MedWand

      MedWand desarrolla y proporciona diversos productos y servicios basados en la nube que facilitan y apoyan Conferencias de telemedicina a través de su tecnología VirtualCare Platform y MedWandSuite de desarrolladores de dispositivos. MedWand también ...

    • MedWand Manuales de usuario del dispositivo

      Haga clic aquí para abrir el MANUAL PATIENTE Haga clic aquí para abrir el MANUAL HCP

    • Tutorial de autoexamen del paciente

      Transcripción Realizar un autoexamen comienza mediante un navegador para navegar a la página de entrada del código de examen. Normalmente situado en elwkiosk.medwand.com wand.com a menos que se indique lo contrario. Aquí introducirá su código de seis ...