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.
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
3Crear un preinforme
| Campo | Oblig. | Descripción |
|---|---|---|
pdf | sí | el PDF que emite el equipo (hasta 8 MB) |
referencia | recom. | tu identificador del estudio; vuelve en toda respuesta y en el PDF |
motivo | opc. | motivo/observación clínica. No escribas el nombre ni el documento del paciente |
cie10 | opc. | código CIE-10 (ej. I20) |
sexo | opc. | M o F (afina el umbral de QTc prolongado) |
edad | opc. | años (0–120) |
area | opc. | 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
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
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)
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.
| Campo | Tipo | Descripción |
|---|---|---|
urgencia.nivel | string | CRITICO, PRIORITARIO, RUTINA o NO INTERPRETABLE |
urgencia.plazo | string | tiempo hasta la acción (AHORA, en este turno…) |
urgencia.motivo | string | por qué ese nivel |
urgencia.conducta | string | qué hacer ahora, en una línea; null si no aplica |
parametros_registro | objeto | { 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, confianza | string | AGUDO/MONITOREO/PREQUIRURGICO/SCREENING · ALTA/MEDIA/BAJA |
resumen, mensaje | string | una línea esencial · el mensaje clínico |
estudios_sugeridos | string[] | estudios/interconsultas sugeridos |
mediciones, descripcion | objeto | FC, PR, QRS, QT/QTc, eje · calidad, ritmo, conducción, ST-T |
checklist | objeto[] | { item, estado, clase }; clase ∈ presente, no_valorable, ausente, no_aplica |
borrador_informe | objeto | { descripcion, conclusion } en el formato escrito de la clínica |
preinforme_texto | string | el preinforme completo en texto |
anonimizacion, disclaimer | objeto/string | qué se anonimizó · la leyenda de "no diagnóstico" |
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ódigo | Significado | Qué hacer |
|---|---|---|
| 202 | trabajo creado | guardá el id y empezá a consultar |
| 200 / 204 | ok / borrado | — |
| 401 | falta la clave o es inválida | revisá el header Authorization |
| 404 | no existe, no es tuyo, o venció | no reintentes a ciegas |
| 409 | PDF pedido antes de estar listo, o terminó en error | esperá o leé el error |
| 413 / 415 | PDF > 8 MB / el archivo no es un PDF | reducí o enviá el PDF del equipo |
| 429 | demasiados pedidos, o cupo lleno | esperá 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
errorclaro. - 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.
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
errorclaro).
Preinforme asistido por IA. No constituye un diagnóstico y requiere validación médica; el criterio clínico prevalece.