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

API pro zdravotnická data

Kam jdou jednotlivé typy zdravotnických dat v Anpheros API, jak jsou kódovány a jak je zapisovat, filtrovat, sledovat, opravovat a mazat — s funkčními příklady.

Medicínská datová API poskytuje softwaru strukturovaný přístup k obsahu záznamů pacientů: vytvořit pacienta, zaznamenat naměřený krevní tlak, vypsat aktivní léky, připojit laboratorní zprávu, sledovat, kdo co zapsal. Tato stránka popisuje datové operace Anpheros API — kam který druh medicínských dat směřuje, jak je kódován a jak si jej přečíst zpět — s příklady, které fungují proti sandboxu.

Aplikace používají tyto operace k tomu, aby Anpheros sloužil jako medicínská databáze jejich produktu: záznamy pacientů žijí v HL7 FHIR R4 úložišti platformy a aplikace je čte a zapisuje prostřednictvím API namísto toho, aby si udržovala vlastní tabulky medicínských dat.

Pro širší kontext (autentizace, souhlas, události) viz Healthcare API.

Kam která data ukládáme

Lékařská data	REST v1	FHIR resource	Kódování
Osoba	`POST /v1/patients`	`Patient`	jméno, datum narození, pohlaví, identifikátory
Vitální funkce, laboratorní výsledky, symptomy, aktivita, dotazníky	`/v1/patients/{id}/observations`	`Observation`	LOINC (symptomy: kapitola R ICD-10); jednotky UCUM
Diagnózy a problémy	`/v1/patients/{id}/conditions`	`Condition`	ICD-10
Léky	`/v1/patients/{id}/medications`	`MedicationStatement`	ATC, název produktu ponechán jako text
Dokumenty (PDF, obrázky)	`/v1/patients/{id}/documents`	`DocumentReference`	typy dokumentů LOINC
Celá laboratorní zpráva	`POST /v1/patients/{id}/labs/import`	`Observation` (laboratory)	LOINC, pokud je znám, jinak vlastní kód laboratoře
Podané nebo vynechané dávky, očkování, alergie, procedury, zprávy, plány péče, cíle, doporučení, návštěvy, schůzky, týmy péče, rodinná anamnéza, dotazníky	`/fhir/R4/{type}`	`MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse`	dle FHIR code systems

Objekty REST v1 a FHIR resource jsou stejné záznamy se stejnými ID; každý objekt v1 nese svůj odkaz fhir.

Zápis lékařských dat

# a lab result with its reference range, linked to the report it came from
curl -X POST https://platform.anpheros.com/v1/patients/$PID/observations \
     -H "Authorization: Bearer $KEY" -H 'content-type: application/json' -H "Idempotency-Key: $(uuidgen)" -d '{
  "code": "4548-4", "display": "Hemoglobin A1c", "category": "laboratory",
  "value": 6.4, "unit": "%", "effective_at": "2026-09-01T08:00:00Z",
  "reference_range": {"low": 4.0, "high": 5.6},
  "derived_from": ["DocumentReference/'$DOC'"], "author_type": "import"
}'

Kategorie pozorování: vital-signs, laboratory, symptom, activity, survey, exam, imaging, social-history.
Složené měření, jako je krevní tlak, používají components (systolický 8480-6, diastolický 8462-4 uvnitř panelu 85354-9).
Typy autorů: patient, practitioner, device, import, ai. Bez jednoho platforma zaznamená import.
Kódy, které si nepamatujete: GET /v1/terminology/loinc?q=hba1c prohledá přiloženou podmnožinu LOINC a GET /v1/search?q=metformin katalog symptomů, stavů a léků; pozorování zapsané bez zobrazovaného názvu automaticky získá název LOINC.

Čtení lékařských dat

curl "https://platform.anpheros.com/v1/patients/$PID/observations?category=laboratory&code=4548-4&from=2026-01-01" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/conditions?clinical_status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "https://platform.anpheros.com/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

Koncový bod	Filtry
observations	`category`, `code`, `from`, `to`
conditions	`clinical_status`
medications	`status`
documents	`kind`
timeline	`from`, `to`, `types`

Seznamy jsou stránkované pomocí limit a cursor. Timeline slučuje pozorování, stavy, léky, dokumenty, návštěvy, schůzky, očkování a epizody péče do jednoho chronologického seznamu — přirozeného vstupu pro obrazovku historie pacienta.

Pro cokoli, co REST filtry nepokrývají, použijte vyhledávání FHIR: GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date (platforma FHIR).

Sledování a opravy dat

Kdo to napsal: GET /v1/patients/{id}/provenance/{type}/{resourceId} — jeden záznam na verzi, s typem autora, projektem, organizací a zdrojovým systémem.
Každá verze: GET /fhir/R4/{type}/{id}/_history; aktualizujte pomocí If-Match, abyste předešli přepsání cizí změny.
Vlastnictví: se souhlasem můžete číst, co napsaly jiné organizace, ale měnit nebo mazat pouze to, co napsal váš projekt (jinak 403).
Mazání: DELETE /v1/{observations|conditions|medications}/{id}; smazáním Patient se smaže celý záznam.

Dokumenty

Vytvořte dokument (získáte cílové místo pro nahrání), nahrajte bajty prostřednictvím platformy nebo přímo do úložiště a poté jej finalizujte. Po finalizaci je originál neměnný; jeho SHA-256 a velikost jsou zaznamenány. Maximálně 25 MiB na soubor.

Související

Jak normalizovat lékařská data: kódy, jednotky, data, duplicity, validace
Vysvětlení původu lékařských dat: kdo co napsal a jak to zaznamenat
Healthcare API
Zdravotní záznam pacienta
Vytvoření zdravotnické aplikace
Referenční příručka API (OpenAPI) · Začínáme

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