Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Egészségügyi adat API
Hová kerül az Anpheros API-ban az egyes egészségügyi adatok típusai, hogyan kódolódnak, és hogyan írhatók, szűrhetők, követhetők nyomon, javíthatók és törölhetők – működő példákkal.
Az orvosi adatok API-ja strukturált hozzáférést biztosít a szoftverek számára a páciensrekordok tartalmához: hozzon létre egy pácienst, rögzítsen egy vérnyomásmérést, listázza az aktív gyógyszereket, csatoljon egy laborjelentést, kövesse nyomon, ki mit írt. Ez az oldal az Anpheros API adatkezelési műveleteit írja le – hogy az orvosi adatok melyik típusa hová kerül, hogyan kódolják őket, és hogyan lehet őket visszaolvasni – működő példákkal a sandbox ellen.
Az alkalmazások ezeket a műveleteket használják arra, hogy az Anpherost termékük orvosi adatbázisaként kezeljék: a páciensrekordok a platform HL7 FHIR R4 tárolójában élnek, és az alkalmazás az API-n keresztül olvassa és írja őket ahelyett, hogy saját orvosi adatokat tartalmazó táblákat tartana fenn.
A szélesebb körű áttekintésért (hitelesítés, hozzájárulás, események) lásd: Egészségügyi API.
Hová kerül az egyes orvosi adatok
| Orvosi adatok | REST v1 | FHIR erőforrás | Kódolás |
|---|---|---|---|
| A személy | POST /v1/patients |
Patient |
name, birth date, gender, identifiers |
| Életjelek, laboreredmények, tünetek, aktivitás, felmérések | /v1/patients/{id}/observations |
Observation |
LOINC (tünetek: ICD-10 R fejezet); UCUM egységek |
| Diagnózisok és problémák | /v1/patients/{id}/conditions |
Condition |
ICD-10 |
| Gyógyszerek | /v1/patients/{id}/medications |
MedicationStatement |
ATC, product name kept as text |
| Dokumentumok (PDF, képek) | /v1/patients/{id}/documents |
DocumentReference |
LOINC document kinds |
| Egy teljes laborjelentés | POST /v1/patients/{id}/labs/import |
Observation (laboratory) |
LOINC where known, the lab's own code otherwise |
| Bevett vagy kihagyott dózisok, oltások, allergiák, eljárások, jelentések, gondozási tervek, célok, beutalók, látogatások, időpontok, gondozási csapatok, családi anamnézis, kérdőívek | /fhir/R4/{type} |
MedicationAdministration, Immunization, AllergyIntolerance, Procedure, DiagnosticReport, CarePlan, Goal, ServiceRequest, Encounter, Appointment, CareTeam, FamilyMemberHistory, QuestionnaireResponse |
per FHIR code systems |
A REST v1 objektumok és a FHIR erőforrások ugyanazok a rekordok, ugyanazokkal az azonosítókkal; minden v1 objektum tartalmazza a fhir hivatkozást.
Orvosi adatok írása
# 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"
}'
- Megfigyelési kategóriák:
vital-signs,laboratory,symptom,activity,survey,exam,imaging,social-history. - Összetett mérések, mint például a vérnyomás,
components-at használnak (szisztolés8480-6, diasztolés8462-4a panelen85354-9belül). - Szerzőtípusok:
patient,practitioner,device,import,ai. Enélkül a platformimport-et rögzít. - Kódok, amelyeket nem tud fejből: a
GET /v1/terminology/loinc?q=hba1ckeres a csomagolt LOINC részhalmazban, aGET /v1/search?q=metforminpedig a tünetek, állapotok és gyógyszerek katalógusában; egy megjelenítési név nélkül írt megfigyelés automatikusan megkapja a LOINC nevet.
Orvosi adatok olvasása
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"
| Végpont | Szűrők |
|---|---|
| observations | category, code, from, to |
| conditions | clinical_status |
| medications | status |
| documents | kind |
| timeline | from, to, types |
A listák lapozása a limit és a cursor segítségével történik. A timeline az észleléseket, állapotokat, gyógyszereket, dokumentumokat, látogatásokat, időpontokat, oltásokat és gondozási epizódokat egy kronologikus listává egyesíti – ez a természetes bemenet egy páciens kórtörténeti képernyőjéhez.
Minden olyan esetben, amit a REST szűrők nem fednek le, használja a FHIR keresést: GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date (FHIR platform).
Adatok nyomon követése és javítása
- Ki írta:
GET /v1/patients/{id}/provenance/{type}/{resourceId}— egy bejegyzés verziónként, szerző típusával, projektjével, szervezetével és forrásrendszerével. - Minden verzió:
GET /fhir/R4/{type}/{id}/_history; frissítse aIf-Matchhasználatával, hogy elkerülje mások módosításainak felülírását. - Tulajdonjog: beleegyezéssel elolvashatja, mit írtak más szervezetek, de csak azt módosíthatja vagy törölheti, amit a saját projektje írt (ellenkező esetben
403). - Törlés:
DELETE /v1/{observations|conditions|medications}/{id}; egyPatienttörlése az egész rekordot törli.
Dokumentumok
Hozza létre a dokumentumot (kap egy feltöltési célt), töltse fel a bájtokat a platformon vagy közvetlenül a tárhelyre, majd fejezze be. Befejezés után az eredeti megváltoztathatatlan; rögzítésre kerül a SHA-256 és a mérete. Fájlonként legfeljebb 25 MiB.
Kapcsolódó
- Orvosi adatok normalizálása: kódok, egységek, dátumok, duplikátumok, validálás
- Egészségügyi adatok eredetének magyarázata: ki mit írt, és hogyan rögzítsük
- Egészségügyi API
- Beteg kórtörténete
- Egészségügyi alkalmazás fejlesztése
- API referencia (OpenAPI) · Első lépések
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card