Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

API de datos longitudinales del paciente

Q: ¿Qué API proporciona una vista cronológica del registro de un paciente?

En Anpheros, GET /v1/patients/{id}/timeline devuelve entradas de ocho tipos de recursos en orden de fecha, con paginación y filtros de fecha y tipo. Para los datos FHIR completos, utilice Patient/$everything.

El historial de un paciente a lo largo del tiempo de clínicas, laboratorios, apps y dispositivos: qué necesita un registro longitudinal y cuatro formas de leerlo — línea de tiempo, $everything, IPS y contexto de IA.

Una API de datos longitudinales del paciente devuelve el historial de salud de una persona a lo largo del tiempo —diagnósticos, medicamentos, resultados de laboratorio, signos vitales, vacunas y visitas de todas las fuentes— como un único registro ordenado en lugar de documentos separados por proveedor. Anpheros mantiene ese historial como un único registro HL7 FHIR R4 por paciente, escrito por clínicas, laboratorios, aplicaciones y dispositivos, conservando cada versión y cada autor. Los desarrolladores lo leen de cuatro maneras: una línea de tiempo cronológica, el registro FHIR completo con Patient/$everything, un Resumen Internacional del Paciente (IPS) o un contexto compacto para modelos de IA.

Many sources, one longitudinal record

ClinicsVisits, diagnoses and prescriptions as FHIR R4
LaboratoriesHL7 v2, CSV or JSON reports become Observations
Apps and devicesReadings from phones, watches and home devices
One FHIR recordEvery version kept, every write with provenance
Your applicationTimeline, $everything, IPS summary or AI context

Lo que "longitudinal" requiere

Una lista de resultados aún no es un registro longitudinal. Para que una aplicación confíe en un historial que abarca años y proveedores, cada entrada debe contener:

Requisito	Por qué es importante	Cómo lo almacena Anpheros
Un significado codificado	Los valores de diferentes laboratorios deben ser comparables	LOINC para resultados, ICD-10 para condiciones, ATC para medicamentos
Una fecha clínica	Ordenar por cuándo ocurrió, no cuándo se cargó	fechas `effective`, `onset`, `occurrence` en cada recurso
El autor	El diagnóstico de un médico y la nota de un paciente no son iguales	Provenance en cada escritura: tipo de autor, persona, organización, sistema de origen
Cada versión	Las correcciones no deben borrar lo que se sabía antes	Historial de versiones en cada recurso (`_history`)
Consentimiento	Otras aplicaciones ven el historial solo si la persona está de acuerdo	Concesiones de OAuth con ámbitos, caducidad y un registro de acceso

Un registro, múltiples escritores

One patient, many writers, one timeline (illustrative data)

Mar 2019Type 2 diabetesCondition · ICD-10 E11 · written by the GP practice
Mar 2019Metformin 500 mgMedicationStatement · ATC A10BA02
Sep 2023HbA1c 7.4 %Observation · LOINC 4548-4 · imported from the laboratory
Oct 2024Influenza vaccineImmunization · written by the pharmacy
Jun 2026Cardiology visitEncounter · written by the clinic
Oct 2026Blood pressure 138/86 mmHgObservation · from the patient's app

Condition Medication Observation Immunization Encounter

Cuatro formas de leer el historial

Necesidad	Endpoint	Lo que obtienes
Un feed cronológico para una pantalla	`GET /v1/patients/{id}/timeline`	Elementos de ocho tipos (observation, condition, medication, document, encounter, appointment, immunization, episode) con fecha, título, resumen y la referencia FHIR; filtrar con `from`, `to`, `types`
El registro completo como FHIR	`GET /fhir/R4/Patient/{id}/$everything`	Un Bundle de searchset; se admiten `_since`, `_type`, `_count` y `_offset`
Un resumen clínico compartible	`GET /fhir/R4/Patient/{id}/$summary`	Un documento de International Patient Summary (IPS)
Entrada para un modelo de IA	`POST /v1/context`	Secciones dentro de un presupuesto de tokens, cada hecho etiquetado con su fuente

La línea de tiempo con el SDK de TypeScript:

import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });   // a sandbox key, sk_test_…
const { data: patients } = await anpheros.patients.list();
const page = await anpheros.timeline.list(patients[0].id, {
  from: '2025-01-01',
  types: 'condition,medication,observation',
  limit: 50,
});
for (const item of page.data) console.log(item.date, item.type, item.title);

Y el mismo registro como FHIR, limitado a lo que cambió desde una fecha:

curl -H "Authorization: Bearer $ANPHEROS_KEY" \
  "https://platform.anpheros.com/fhir/R4/Patient/$PATIENT/\$everything?_since=2026-01-01&_type=Observation,Condition"

Mantener tu copia sincronizada

Si tu aplicación mantiene su propia vista del historial, suscríbete a los webhooks resource.created, resource.updated y resource.deleted. Estos también se activan cuando otro proyecto escribe en un registro al que tienes acceso, con data.external: true y el escritor en data.source, para que los datos de otras clínicas lleguen a ti sin necesidad de sondeos.

Límites a tener en cuenta

El registro contiene lo que se escribió en él. Anpheros no recupera el historial de hospitales o redes nacionales por sí solo; las clínicas, laboratorios, aplicaciones y la persona lo escriben.
Se almacenan 26 tipos de recursos FHIR R4. Los recursos de facturación como Claim y ExplanationOfBenefit no se almacenan.
Otras aplicaciones leen el historial de una persona solo con el consentimiento de esa persona; la clave propia de un proyecto ve los pacientes que creó.

Preguntas frecuentes

¿Qué son los datos longitudinales del paciente?

La información de salud de una persona recopilada a lo largo del tiempo y en diferentes entornos de atención —diagnósticos, medicamentos, resultados, signos vitales, vacunas y visitas— se conserva para que pueda leerse como un historial continuo.

¿Qué API proporciona una vista cronológica del registro de un paciente?

En Anpheros, GET /v1/patients/{id}/timeline devuelve entradas de ocho tipos de recursos en orden de fecha, con paginación y filtros de fecha y tipo. Para los datos FHIR completos, utilice Patient/$everything.

¿El historial se almacena en un formato estándar?

Sí. Cada entrada es un recurso HL7 FHIR R4 con códigos estándar (LOINC, ICD-10, ATC, CVX, UCUM), y el resumen es un Resumen Internacional del Paciente (IPS).

¿Cómo sé quién escribió cada entrada?

Cada escritura crea un recurso Provenance con el tipo de autor (paciente, profesional, dispositivo, importación o IA), la persona, la organización y el sistema de origen.

¿Puedo probar con datos longitudinales realistas?

Sí. Cada proyecto sandbox comienza con 30 pacientes sintéticos con aproximadamente seis meses de condiciones, medicamentos, resultados de laboratorio y signos vitales.

Relacionado

Aplicación de registro de salud personal (PHR) con FHIR: una línea de tiempo en una aplicación real
Procedencia de datos médicos explicada
Plataforma de consentimiento del paciente para aplicaciones de salud
Cómo almacenar registros médicos usando FHIR R4
Agentes de IA y datos médicos: el endpoint de contexto
Webhooks

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card