drimian ยท ECG API v1.0 Swagger ↗

API de preinforme de electrocardiograma

Enviás el PDF que emite tu equipo de ECG y recibís el preinforme en dos formas: JSON estructurado para tu software y un PDF listo para mostrar o adjuntar. El mismo motor que corre en producción en Clínica Foianini: mediciones deterministas de las doce derivaciones, checklist de más de veinte hallazgos y árbol de urgencia.

Base URL  https://ecg-api.drimian.com Formato  JSON · UTF-8 Preinforme asistido por IA — no es diagnóstico

1Autenticación

Cada pedido lleva tu clave en el encabezado Authorization:

Authorization: Bearer dre_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • La clave te la entregamos por un canal seguro y se muestra una sola vez; guardala como un secreto (nosotros guardamos solo su hash).
  • Para rotarla o revocarla, avisanos: emitimos una nueva y damos de baja la anterior.
  • Sin clave válida, la respuesta es 401. No la pongas en URLs ni en logs.

2Cómo funciona

El análisis tarda alrededor de un minuto. Para no mantener una conexión abierta todo ese tiempo, el flujo es asincrónico en tres pasos: creás el trabajo, consultás hasta que esté listo y retirás el resultado.

1) POST /v1/preinformes        (subís el PDF)      → 202  { id, estado: "procesando" }
2) GET  /v1/preinformes/{id}    (cada 3-5 s)         → 200  { estado: "listo", resultado: {...} }
3) GET  /v1/preinformes/{id}/pdf                      → 200  application/pdf
   DELETE /v1/preinformes/{id}  (opcional)           → 204
No guardamos nada. El PDF que subís se borra apenas se procesa; el resultado vive solo en memoria y se borra a los 15 minutos (o cuando lo borrás vos). Retiralo dentro de esa ventana.

3Crear un preinforme

POST/v1/preinformesmultipart/form-data
CampoOblig.Descripción
pdfsíel PDF que emite el equipo (hasta 8 MB)
referenciarecom.tu identificador del estudio; vuelve en toda respuesta y en el PDF
motivoopc.motivo/observación clínica. No escribas el nombre ni el documento del paciente
cie10opc.código CIE-10 (ej. I20)
sexoopc.M o F (afina el umbral de QTc prolongado)
edadopc.años (0–120)
areaopc.dónde se tomó (ver abajo); default Consultorio externo
# respuesta 202
{ "id": "3pQ8xk2mN0aT", "estado": "procesando", "referencia": "EK-2026-0001",
  "escenario": "AGUDO", "_links": { "self": "/v1/preinformes/3pQ8xk2mN0aT", "pdf": ".../pdf" } }
curl -X POST https://ecg-api.drimian.com/v1/preinformes \
  -H "Authorization: Bearer dre_live_xxxx" \
  -F "pdf=@estudio.pdf;type=application/pdf" \
  -F "referencia=EK-2026-0001" -F "motivo=dolor precordial de 2 horas" \
  -F "cie10=I20" -F "sexo=M" -F "edad=68" -F "area=Emergencia"

Áreas válidas: Consultorio externo, Imagen Medica, Emergencia, UCI Adultos, UCI Pediatrica, Internacion piso, Recuperacion, Domiciliaria.

4Consultar el estado

GET/v1/preinformes/{id}

estado: procesando → listo (o error). Cuando es listo, trae el preinforme en resultado. Consultá cada 3–5 segundos; suele estar listo en ~60–90 s.

curl https://ecg-api.drimian.com/v1/preinformes/3pQ8xk2mN0aT \
  -H "Authorization: Bearer dre_live_xxxx"

5Descargar el PDF

GET/v1/preinformes/{id}/pdfapplication/pdf

Disponible cuando el estado es listo. Si todavía procesa, responde 409.

curl https://ecg-api.drimian.com/v1/preinformes/3pQ8xk2mN0aT/pdf \
  -H "Authorization: Bearer dre_live_xxxx" -o preinforme.pdf

6Borrar (opcional)

DELETE/v1/preinformes/{id}

Lo saca de memoria en el acto (204). Si no lo borrás, vence solo. También hay GET /v1/salud para monitoreo.

7El objeto resultado

Referenciado por tu referencia, sin datos identificatorios del paciente.

CampoTipoDescripción
urgencia.nivelstringCRITICO, PRIORITARIO, RUTINA o NO INTERPRETABLE
urgencia.plazostringtiempo hasta la acción (AHORA, en este turno…)
urgencia.motivostringpor qué ese nivel
urgencia.conductastringqué hacer ahora, en una línea; null si no aplica
parametros_registroobjeto{ aviso, fuera_de_estandar } cuando el estudio no se tomó o no se imprimió con los parámetros estándar; null en el caso normal
escenario, confianzastringAGUDO/MONITOREO/PREQUIRURGICO/SCREENING · ALTA/MEDIA/BAJA
resumen, mensajestringuna línea esencial · el mensaje clínico
estudios_sugeridosstring[]estudios/interconsultas sugeridos
mediciones, descripcionobjetoFC, PR, QRS, QT/QTc, eje · calidad, ritmo, conducción, ST-T
checklistobjeto[]{ item, estado, clase }; clase ∈ presente, no_valorable, ausente, no_aplica
borrador_informeobjeto{ descripcion, conclusion } en el formato escrito de la clínica
preinforme_textostringel preinforme completo en texto
anonimizacion, disclaimerobjeto/stringqué se anonimizó · la leyenda de "no diagnóstico"
La clase importa: no_valorable significa "el trazado no permitió evaluarlo" — no es lo mismo que ausente ("se descartó"). No los trates igual.

8Códigos de estado

CódigoSignificadoQué hacer
202trabajo creadoguardá el id y empezá a consultar
200 / 204ok / borrado—
401falta la clave o es inválidarevisá el header Authorization
404no existe, no es tuyo, o vencióno reintentes a ciegas
409PDF pedido antes de estar listo, o terminó en erroresperá o leé el error
413 / 415PDF > 8 MB / el archivo no es un PDFreducí o enviá el PDF del equipo
429demasiados pedidos, o cupo llenoesperá y reintentá con backoff

Los errores traen un cuerpo { "error": "..." } legible.

9Privacidad, NDA y aislamiento

  • Antes de procesar, quitamos los datos identificatorios: la imagen viaja con el pie en blanco (nombre y fecha tapados y verificados) y el texto libre con las fichas de identidad borradas. Si no se puede garantizar, el estudio no se procesa y recibís un error claro.
  • No escribas el nombre ni el documento del paciente en motivo: ese texto viaja tal cual.
  • El preinforme no incluye identidad: lo asociás por tu referencia.
  • Conforme al NDA: solo se intercambian datos anonimizados/disociados, y las salidas no se usan para entrenar modelos.
Aislamiento. Cada estudio se procesa de forma independiente, solo con el PDF y los campos que enviás. El servicio no consulta ninguna historia clínica externa; tus pacientes no se cruzan con ningún otro origen de datos.

10Cliente de ejemplo (Python)

import time, requests

BASE = "https://ecg-api.drimian.com"
H = {"Authorization": "Bearer dre_live_xxxx"}

def preinforme(pdf_path, referencia, **campos):
    with open(pdf_path, "rb") as f:
        r = requests.post(BASE + "/v1/preinformes", headers=H,
                          files={"pdf": ("estudio.pdf", f, "application/pdf")},
                          data={"referencia": referencia, **campos})
    r.raise_for_status()
    ident = r.json()["id"]
    for _ in range(45):                       # ~3 min de margen
        s = requests.get(f"{BASE}/v1/preinformes/{ident}", headers=H).json()
        if s["estado"] == "listo":
            pdf = requests.get(f"{BASE}/v1/preinformes/{ident}/pdf", headers=H).content
            requests.delete(f"{BASE}/v1/preinformes/{ident}", headers=H)   # opcional
            return s["resultado"], pdf
        if s["estado"] == "error":
            raise RuntimeError(s.get("error"))
        time.sleep(4)
    raise TimeoutError("no estuvo listo a tiempo")

datos, pdf_bytes = preinforme("estudio.pdf", "EK-2026-0001",
                              motivo="dolor precordial", sexo="M", edad="68", area="Emergencia")
print(datos["urgencia"]["nivel"], "-", datos["resumen"])
open("preinforme.pdf", "wb").write(pdf_bytes)

11Límites y recomendaciones

  • Tamaño del PDF: hasta 8 MB (un ECG vectorial pesa 40–400 kB).
  • Vencimiento del resultado: 15 minutos en memoria; retiralo dentro de esa ventana.
  • Rate-limit por clave y cupo de análisis concurrentes: ante 429, reintentá con backoff (5 s, 10 s, 20 s).
  • Insumo: solo el PDF. El .eevm/señal cruda no aporta y no se usa.
  • Formato: el motor conoce la impresión estándar de "ECG View" (A4 apaisada, doce derivaciones); otros formatos o escaneos pueden no analizarse (recibís un error claro).
Drimian S.R.L. · Santa Cruz de la Sierra, Bolivia. Documentación del API de preinforme de ECG, v1.0. Referencia interactiva siempre al día en /v1/docs. Para altas, rotación de claves o soporte de integración, escribinos.

Preinforme asistido por IA. No constituye un diagnóstico y requiere validación médica; el criterio clínico prevalece.