API de datos de salud: qué buscar y cómo leer y escribir un registro de paciente en una hora

"API de salud" abarca cosas muy diferentes: el feed HL7 v2 de un hospital, un servicio nacional de prescripción electrónica, la exportación de un proveedor de wearables, un servidor FHIR. Si estás creando una aplicación de salud, una herramienta clínica o un asistente de IA, lo que necesitas es algo más específico: un backend que almacene el historial de un paciente en un formato estándar, permita al paciente decidir quién lo lee y te ofrezca una API limpia. Esta guía te dice qué buscar y muestra, con llamadas reales, cómo es la primera hora en la Plataforma Anpheros.

Versión técnica para desarrolladores: API de salud · API de datos médicos en developers.anpheros.com, con solicitudes, respuestas y límites. Esta página es la versión en lenguaje sencillo.

Lo que una API de datos de salud debe hacer

Cinco cosas diferencian una API de datos de salud utilizable de una base de datos con HTTP delante.

• Un formato estándar. HL7 FHIR R4 es el formato que utilizan los hospitales, los sistemas nacionales y el espacio de datos de salud de la UE. Un registro almacenado en FHIR puede ser leído por otros sistemas sin un puente personalizado. Un JSON propietario no puede.
• Consentimiento del paciente como objeto de primera clase. Quién puede leer qué, durante cuánto tiempo, revocable, visible para el paciente. No una casilla de verificación en tu propia base de datos.
• Procedencia. Cada valor indica quién lo escribió: el paciente, un profesional, un dispositivo, una importación, un cálculo derivado. Un asistente de IA que no puede distinguir un resultado de laboratorio de una suposición autoinformada es peligroso.
• Un sandbox con datos realistas. No puedes probar con pacientes reales, y no deberías tener que inventar tú mismo 30 pacientes sintéticos con seis meses de historial.
• Residencia de datos que puedas nombrar. Para los usuarios europeos, esto significa servidores en la UE, bajo GDPR, con un acuerdo de procesamiento de datos.

Dos formas de acceder: REST y FHIR, mismos datos

La Plataforma Anpheros expone el mismo registro dos veces. Una API REST simple (/v1) para el código del producto, y FHIR R4 estricto (/fhir/R4) para todo lo que deba comunicarse con el resto del sistema de salud. Los IDs son idénticos en ambos; cada objeto v1 lleva su referencia fhir.

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# pacientes que tu proyecto puede ver
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# resultados de laboratorio, los más recientes primero
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# medicamentos activos
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# todo en una línea de tiempo
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# los mismos datos, FHIR estricto
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

Detrás de estas llamadas hay 26 tipos de recursos FHIR (Paciente, Observación, Condición, Declaración de Medicamento, Intolerancia a Alergias, Inmunización, Referencia de Documento, Encuentro, Consentimiento, Procedencia y más), codificados con LOINC para mediciones, ICD-10 para condiciones y ATC para medicamentos.

Obtener una clave lleva un minuto

El sandbox es autoservicio y gratuito. Inicia sesión en el panel en platform.anpheros.com/dashboard, pulsa Obtener una clave de sandbox, y tendrás una organización, un proyecto sandbox y una clave sk_test_…. El proyecto viene con su propia copia de 30 pacientes sintéticos: adultos, niños y personas mayores de toda la UE, con condiciones, medicamentos, alergias, resultados de laboratorio y signos vitales durante seis meses. Cambia o elimina cualquier cosa; un reinicio los devuelve.

Las claves de producción (sk_live_…) se otorgan a organizaciones verificadas con un acuerdo de procesamiento de datos firmado. El sandbox y la producción son bases de datos diferentes: una clave de sandbox físicamente no puede acceder a un paciente real.

¿Qué más hay en la caja?

• OAuth 2.1 con PKCE y lanzamiento independiente de SMART on FHIR, para que una aplicación pueda solicitar a una persona acceso a su propio historial.
• Consentimiento con ámbitos, caducidad y revocación, y un registro de acceso que el paciente puede leer.
• Webhooks firmados (HMAC-SHA256, reintentados con retroceso) para resource.created, consent.granted, consent.revoked, document.finalized.
• Una API de contexto de IA que crea un resumen con etiquetas de procedencia de un paciente dentro de un presupuesto de tokens.
• Importación de informes de laboratorio desde CSV, HL7 v2 ORU^R01 o JSON, mapeado a LOINC.
• Resumen Internacional del Paciente ($summary) y Enlaces de Salud SMART para compartir mediante QR.
• SDKs para Dart y TypeScript, una referencia OpenAPI en /docs y una Declaración de Capacidad en /fhir/R4/metadata.

El recorrido completo, con respuestas, está en developers.anpheros.com/guides/first-hour.

Preguntas frecuentes

¿Hay una API de salud gratuita con la que pueda empezar hoy mismo?

Sí. El sandbox de Anpheros es gratuito y autoservicio: inicia sesión, obtén una clave y tendrás 30 pacientes sintéticos para leer y escribir. Los límites son 10 000 escrituras de recursos al día, 100 pacientes propios y 250 MB de documentos por proyecto.

¿REST o FHIR, cuál debería usar?

Usa /v1 para el código de tu propio producto: es más simple y devuelve JSON plano. Usa /fhir/R4 cuando otro sistema tenga que leer los datos, cuando necesites búsqueda FHIR, _history, $everything o $summary, o cuando una certificación lo solicite. Ambos ven el mismo registro.

¿Cómo se maneja el consentimiento del paciente?

Una persona otorga a una aplicación acceso a su historial a través de OAuth, eligiendo ámbitos y una duración (30, 90, 180 o 365 días). La concesión se puede revocar en cualquier momento, y el paciente ve cada lectura en un registro de acceso. Detalles en el modelo de consentimiento.

¿Dónde se alojan los datos?

En la Unión Europea (Cloud Run, europe-west4), con procedencia e historial de versiones en cada escritura. El uso en producción requiere un acuerdo de procesamiento de datos firmado.

¿Cuánto cuesta la producción?

La producción comienza en 49 € al mes para 2 500 pacientes almacenados, con el primer mes gratis; los planes más grandes cuestan 199 € y 799 € al mes. El sandbox sigue siendo gratuito. Consulta precios.

¿Funciona con agentes de IA?

Sí. Hay una API de contexto de IA con etiquetas de procedencia y un presupuesto de tokens, y un servidor MCP en platform.anpheros.com/mcp al que cualquier asistente compatible con MCP puede conectarse. Consulta Integración de EMR con asistentes médicos de IA.