Conectá tu sistema a Ellie Care

01¿Qué es Ellie Care?

02Los protagonistas

Seis actores. Entender quién es quién es la mitad del modelo mental — el resto de la API cae solo.

03Cómo funciona

El ciclo de la teleasistencia en cuatro pasos; la API te engancha en el paso 4. Por debajo, una sola puerta (api.ellie.care) te autentica, te aísla por empresa y zona, y te entrega solo lo tuyo.

04El reloj: qué mide

El reloj hace tres cosas: mide vitales continuos mientras se usa, ejecuta chequeos a pedido, y detecta eventos de seguridad.

Vitales continuos — mientras el reloj está puesto

Señales del dispositivo — técnicas, no clínicas

Llegan por el canal device.status y en GET /devices/{id}. Sirven para adherencia y operación.

Telechequeos — mediciones guiadas, a pedido

Tu sistema (o un operador) pide una medición; el reloj guía al paciente, toma la muestra y devuelve un resultado con estado done/failed/deferred.

Seguridad de vida

05Señal vs. alerta

La distinción que evita malentendidos: Ellie te manda señales crudas, no veredictos clínicos.

Por eso el contrato separa eventos clínicos (clinical.event), estado del dispositivo (device.status) y alertas (vida). Ellie evita pre-juzgar: te da la señal para que tu sistema aplique su propia lógica clínica.

06Qué podés hacer con la API

Todo scopeado a tu empresa (sale del token) y tus pacientes. En lenguaje de negocio:

07Primeros pasos y Quickstart

De cero a tu primer dato, sin datos reales. El mapa, y después el código.

# base del sandbox (datos sintéticos)
BASE=https://api-sandbox.ellie.care

# 1) token OAuth2 (el empresa_id + zona van dentro del token)
TOKEN=$(curl -s -X POST $BASE/oauth/token \
  -d grant_type=client_credentials \
  -d client_id=ellie_sandbox_br -d client_secret=sandbox \
  -d scope="read:patients read:vitals telecheckup:read" \
  | jq -r .access_token)

# 2) tu primer llamado — sin parámetro de empresa (sale del token)
curl -s $BASE/v1/patients -H "Authorization: Bearer $TOKEN"
curl -s "$BASE/v1/vitals?patient_id=pat_test_001&type=heart_rate" -H "Authorization: Bearer $TOKEN"

¿Preferís explorar sin escribir código? Abrí la referencia interactiva (try-it contra el sandbox).

08Autenticación

OAuth 2.0 client-credentials (app-a-app). Registrás una app → client_id + client_secret. El token es de vida corta y lleva tu empresa_id, tu zone y tus scopes.

09Datos de salud: endpoints

La telemetría y los telechequeos se sirven en dos formas: REST crudo o FHIR R4 estándar. El edge abstrae de dónde salen.

• Telemetría — GET /v1/vitals?patient_id=&type=heart_rate&since=. Tipos: heart_rate, spo2, skin_temperature, ibi, eda, motion (actigrafía ENMO), steps, calories, ppg/ppg_ir/ppg_red, accel_raw. Alto volumen → cursor + since.
• Frecuencia cardíaca agregada por minuto — GET /v1/patients/{id}/vitals/heart-rate?start=&end=. Mediana, máx, mín y cantidad de muestras por minuto. Ventana ≤ 30 días por consulta; para más, paginá.
• Sesiones de sueño — GET /v1/patients/{id}/sleep-sessions. Ventana de sueño con señales promediadas (HR, EDA, HRV, temperatura, actigrafía). Hoja de ruta
• Telechequeos — GET /v1/patients/{id}/telecheckups; se solicitan con POST /v1/telecheckups:request. Siempre reportan estado (done/failed/deferred).
• FHIR — GET /v1/fhir/Observation?patient=&code=8867-4 (LOINC). Devuelve un Bundle R4. Telechequeo emocional como QuestionnaireResponse.

10Eventos (webhooks)

Registrás tu URL vos mismo (self-serve) y Ellie te empuja los eventos crudos (señales, no alertas pre-juzgadas) como CloudEvents. Cada entrega viene firmada con HMAC en X-Ellie-Signature: verificá SIEMPRE la firma. Alternativa sin endpoint: polling GET /v1/events (omití since la primera vez; después ?since=<next_cursor>).

# 1) registrás tu URL → te devuelve el secret UNA sola vez (guardalo)
curl -s -X POST $BASE/v1/subscriptions -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://tu-endpoint/hooks","event_types":["clinical.event","device.status"]}'
# → 201 { "id":"sub_…", "secret":"whsec_…", "status":"active", … }

# 2) probás la entrega firmada de punta a punta (colon literal, no lo URL-encodees)
curl -s -X POST "$BASE/v1/subscriptions/sub_…:test" -H "Authorization: Bearer $TOKEN"
# → 202 { "status":"delivered", "response_status":200 }

const mac = crypto.createHmac("sha256", WEBHOOK_SECRET).update(rawBody).digest("hex");
if (`sha256=${mac}` !== req.header("X-Ellie-Signature")) return res.status(401).end();

Gestionás tus suscripciones con GET /v1/subscriptions y DELETE /v1/subscriptions/{id}.

11Tenencia, zonas y privacidad

Tu empresa_id sale del token — nunca lo mandás por query ni body, y por eso solo ves a tus propios pacientes. Cada empresa tiene una zona de residencia y sus datos de salud no salen de su región.

• Un mismo host (api.ellie.care) te rutea a tu región según el token.
• Pedir un patient_id de otro tenant devuelve 404. Solo ves lo tuyo.
• El sandbox usa datos 100% sintéticos (cero PHI real).

12Casos de uso reales

Lo que las empresas construyen sobre Ellie. Cada uno combina unos pocos endpoints.

13Sandbox → Producción

Es la misma API. Pasar a prod no es reprogramar: cambiás 2 valores (host + credenciales).

14Errores y paginación

Los errores llegan en RFC 9457 (application/problem+json), parseables. La paginación es siempre por cursor (next_cursor), nunca offset.

{ "type": "https://api.ellie.care/errors/insufficient-scope",
  "title": "Falta el scope read:vitals", "status": 403,
  "detail": "Tu token no incluye read:vitals." }

15Preguntas frecuentes

16Glosario

¿Listo para el detalle endpoint por endpoint? Abrí la referencia interactiva y probá contra el sandbox.