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

API pre zdravotnícke údaje

Kam idú jednotlivé druhy zdravotníckych údajov v Anpheros API, ako sú kódované a ako ich zapisovať, filtrovať, sledovať, opravovať a mazať — s funkčnými príkladmi.

Lekárske dáta API poskytuje softvéru štruktúrovaný prístup k obsahu záznamov pacientov: vytvoriť pacienta, zaznamenať meranie krvného tlaku, zoznam aktívnych liekov, priložiť laboratórnu správu, sledovať, kto čo zapísal. Táto stránka popisuje dátové operácie Anpheros API — kam smeruje každý druh lekárskych dát, ako je kódovaný a ako si ho prečítať späť — s príkladmi, ktoré fungujú proti sandboxu.

Aplikácie používajú tieto operácie na to, aby Anpheros považovali za lekársku databázu svojho produktu: záznamy pacientov žijú v HL7 FHIR R4 úložisku platformy a aplikácia ich číta a zapisuje cez API namiesto toho, aby si udržiavala vlastné tabuľky lekárskych dát.

Pre širší obraz (autentifikácia, súhlas, udalosti) si pozrite Healthcare API.

Kam idú jednotlivé druhy lekárskych údajov

Lekárske údaje	REST v1	FHIR resource	Kódovanie
Osoba	`POST /v1/patients`	`Patient`	meno, dátum narodenia, pohlavie, identifikátory
Životné funkcie, laboratórne výsledky, symptómy, aktivita, prieskumy	`/v1/patients/{id}/observations`	`Observation`	LOINC (symptómy: kapitola R ICD-10); jednotky UCUM
Diagnózy a problémy	`/v1/patients/{id}/conditions`	`Condition`	ICD-10
Lieky	`/v1/patients/{id}/medications`	`MedicationStatement`	ATC, názov produktu ponechaný ako text
Dokumenty (PDF, obrázky)	`/v1/patients/{id}/documents`	`DocumentReference`	druhy dokumentov LOINC
Celá laboratórna správa	`POST /v1/patients/{id}/labs/import`	`Observation` (laboratórna)	LOINC, ak je známe, inak vlastný kód laboratória
Užité alebo vynechané dávky, očkovania, alergie, procedúry, správy, plány starostlivosti, ciele, odporúčania, návštevy, stretnutia, tímy starostlivosti, rodinná anamnéza, dotazníky	`/fhir/R4/{type}`	`MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse`	podľa kódovacích systémov FHIR

Objekty REST v1 a zdroje FHIR sú rovnaké záznamy s rovnakými identifikátormi; každý objekt v1 nesie svoj odkaz fhir.

Zapisovanie lekárskych údajov

# 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"
}'

Kategórie pozorovania: vital-signs, laboratory, symptom, activity, survey, exam, imaging, social-history.
Zložené merania, ako je krvný tlak, používajú components (systolický 8480-6, diastolický 8462-4 v rámci panelu 85354-9).
Typy autorov: patient, practitioner, device, import, ai. Bez jedného z nich platforma zaznamená import.
Kódy, ktoré si nepamätáte naspamäť: GET /v1/terminology/loinc?q=hba1c vyhľadá pribalený podskupinu LOINC a GET /v1/search?q=metformin katalóg symptómov, stavov a liekov; pozorovanie napísané bez zobrazovaného názvu automaticky získa názov LOINC.

Čítanie lekárskych údajov

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	Filtre
observations	`category`, `code`, `from`, `to`
conditions	`clinical_status`
medications	`status`
documents	`kind`
timeline	`from`, `to`, `types`

Zoznamy sú stránkované pomocou limit a cursor. Timeline spája pozorovania (observations), stavy (conditions), lieky (medications), dokumenty (documents), návštevy (visits), prehliadky (appointments), očkovania (vaccinations) a epizódy starostlivosti (episodes of care) do jedného chronologického zoznamu — prirodzeného vstupu pre obrazovku anamnézy pacienta.

Pre čokoľvek, čo REST filtre nepokrývajú, použite FHIR search: GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date (FHIR platform).

Sledovanie a oprava údajov

Kto to napísal: GET /v1/patients/{id}/provenance/{type}/{resourceId} — jeden záznam na verziu, s typom autora, projektom, organizáciou a zdrojovým systémom.
Každá verzia: GET /fhir/R4/{type}/{id}/_history; aktualizujte pomocou If-Match, aby ste predišli prepísaniu zmeny niekoho iného.
Vlastníctvo: so súhlasom môžete čítať, čo napísali iné organizácie, ale meniť alebo vymazávať iba to, čo napísal váš projekt (inak 403).
Vymazanie: DELETE /v1/{observations|conditions|medications}/{id}; vymazanie Patient vymaže celý záznam.

Dokumenty

Vytvorte dokument (získate cieľ nahrávania), nahrajte bajty cez platformu alebo priamo do úložiska a potom finalizujte. Po finalizácii je originál nemenný; zaznamená sa jeho SHA-256 a veľkosť. Maximálne 25 MiB na súbor.

Súvisiace

Ako normalizovať lekárske údaje: kódy, jednotky, dátumy, duplicity, validácia
Vysvetlenie pôvodu lekárskych údajov: kto čo napísal a ako to zaznamenať
Healthcare API
Lekársky záznam pacienta
Vytvorenie zdravotníckej aplikácie
Referenčná príručka API (OpenAPI) · Začíname

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