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

API ιατρικών δεδομένων

Πού πηγαίνει κάθε είδος ιατρικών δεδομένων στο API του Anpheros, πώς κωδικοποιείται, και πώς να γράψετε, φιλτράρετε, ανιχνεύσετε, διορθώσετε και διαγράψετε — με λειτουργικά παραδείγματα.

Ένα API ιατρικών δεδομένων παρέχει στο λογισμικό δομημένη πρόσβαση στο περιεχόμενο των αρχείων ασθενών: δημιουργία ασθενούς, καταγραφή μέτρησης αρτηριακής πίεσης, λίστα ενεργών φαρμάκων, επισύναψη εργαστηριακής αναφοράς, εντοπισμός του ποιος έγραψε τι. Αυτή η σελίδα περιγράφει τις λειτουργίες δεδομένων του Anpheros API — πού αντιστοιχεί κάθε είδος ιατρικών δεδομένων, πώς κωδικοποιείται και πώς να τα ανακτήσετε — με παραδείγματα που λειτουργούν στο sandbox.

Οι εφαρμογές χρησιμοποιούν αυτές τις λειτουργίες για να αντιμετωπίζουν το Anpheros ως την ιατρική βάση δεδομένων του προϊόντος τους: τα αρχεία ασθενών βρίσκονται στην αποθήκη HL7 FHIR R4 της πλατφόρμας, και η εφαρμογή τα διαβάζει και τα γράφει μέσω του API αντί να διατηρεί τους δικούς της πίνακες ιατρικών δεδομένων.

Για την ευρύτερη εικόνα (αυθεντικοποίηση, συναίνεση, συμβάντα) δείτε το Healthcare API.

Πού πηγαίνει κάθε είδος ιατρικών δεδομένων

Ιατρικά δεδομένα	REST v1	FHIR resource	Κωδικοποίηση
Το άτομο	`POST /v1/patients`	`Patient`	όνομα, ημερομηνία γέννησης, φύλο, αναγνωριστικά
Ζωτικά σημεία, εργαστηριακά αποτελέσματα, συμπτώματα, δραστηριότητα, έρευνες	`/v1/patients/{id}/observations`	`Observation`	LOINC (συμπτώματα: κεφάλαιο R του ICD-10); μονάδες UCUM
Διαγνώσεις και προβλήματα	`/v1/patients/{id}/conditions`	`Condition`	ICD-10
Φαρμακευτική αγωγή	`/v1/patients/{id}/medications`	`MedicationStatement`	ATC, όνομα προϊόντος διατηρείται ως κείμενο
Έγγραφα (PDF, εικόνες)	`/v1/patients/{id}/documents`	`DocumentReference`	είδη εγγράφων LOINC
Μια ολόκληρη εργαστηριακή αναφορά	`POST /v1/patients/{id}/labs/import`	`Observation` (laboratory)	LOINC όπου είναι γνωστό, αλλιώς ο δικός κωδικός του εργαστηρίου
Δοσολογίες που ελήφθησαν ή παραλείφθηκαν, εμβολιασμοί, αλλεργίες, διαδικασίες, αναφορές, σχέδια φροντίδας, στόχοι, παραπομπές, επισκέψεις, ραντεβού, ομάδες φροντίδας, οικογενειακό ιστορικό, ερωτηματολόγια	`/fhir/R4/{type}`	`MedicationAdministration`, `Immunization`, `AllergyIntolerance`, `Procedure`, `DiagnosticReport`, `CarePlan`, `Goal`, `ServiceRequest`, `Encounter`, `Appointment`, `CareTeam`, `FamilyMemberHistory`, `QuestionnaireResponse`	ανά συστήματα κωδικοποίησης FHIR

Τα αντικείμενα REST v1 και οι πόροι FHIR είναι οι ίδιες εγγραφές με τα ίδια αναγνωριστικά. κάθε αντικείμενο v1 φέρει την αναφορά fhir του.

Εγγραφή ιατρικών δεδομένων

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

Κατηγορίες παρατήρησης: vital-signs, laboratory, symptom, activity, survey, exam, imaging, social-history.
Σύνθετες μετρήσεις όπως η αρτηριακή πίεση χρησιμοποιούν components (συστολική 8480-6, διαστολική 8462-4 εντός του πίνακα 85354-9).
Τύποι συγγραφέων: patient, practitioner, device, import, ai. Χωρίς έναν, η πλατφόρμα καταγράφει import.
Κωδικοί που δεν γνωρίζετε απ' έξω: GET /v1/terminology/loinc?q=hba1c αναζητά το ενσωματωμένο υποσύνολο LOINC και GET /v1/search?q=metformin τον κατάλογο συμπτωμάτων, παθήσεων και φαρμάκων. μια παρατήρηση που γράφεται χωρίς όνομα εμφάνισης λαμβάνει αυτόματα το όνομα LOINC.

Ανάγνωση ιατρικών δεδομένων

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"

Endpoint	Φίλτρα
observations	`category`, `code`, `from`, `to`
conditions	`clinical_status`
medications	`status`
documents	`kind`
timeline	`from`, `to`, `types`

Οι λίστες είναι σελιδοποιημένες με limit και cursor. Η timeline συγχωνεύει παρατηρήσεις (observations), καταστάσεις (conditions), φαρμακευτικές αγωγές (medications), έγγραφα (documents), επισκέψεις (visits), ραντεβού (appointments), εμβολιασμούς (vaccinations) και επεισόδια φροντίδας (episodes of care) σε μία χρονολογική λίστα — την φυσική είσοδο για μια οθόνη ιστορικού ασθενούς.

Για οτιδήποτε δεν καλύπτεται από τα REST φίλτρα, χρησιμοποιήστε την αναζήτηση FHIR: GET /fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date (FHIR platform).

Παρακολούθηση και διόρθωση δεδομένων

Ποιος το έγραψε: GET /v1/patients/{id}/provenance/{type}/{resourceId} — μία καταχώρηση ανά έκδοση, με τύπο συγγραφέα, έργο, οργανισμό και σύστημα πηγής.
Κάθε έκδοση: GET /fhir/R4/{type}/{id}/_history· ενημερώστε με If-Match για να αποφύγετε την παράγραφο αλλαγής κάποιου άλλου.
Ιδιοκτησία: με συναίνεση μπορείτε να διαβάσετε τι έγραψαν άλλοι οργανισμοί, αλλά να αλλάξετε ή να διαγράψετε μόνο ό,τι έγραψε το δικό σας έργο (αλλιώς 403).
Διαγραφή: DELETE /v1/{observations|conditions|medications}/{id}· η διαγραφή ενός Patient διαγράφει ολόκληρη την εγγραφή.

Έγγραφα

Δημιουργήστε το έγγραφο (λαμβάνετε έναν στόχο μεταφόρτωσης), μεταφορτώστε τα bytes μέσω της πλατφόρμας ή απευθείας στο χώρο αποθήκευσης, και στη συνέχεια οριστικοποιήστε. Μετά την οριστικοποίηση, το πρωτότυπο είναι αμετάβλητο· καταγράφονται το SHA-256 και το μέγεθός του. Έως 25 MiB ανά αρχείο.

Σχετικά

Πώς να κανονικοποιήσετε ιατρικά δεδομένα: κωδικοί, μονάδες, ημερομηνίες, διπλότυπα, επικύρωση
Προέλευση ιατρικών δεδομένων εξηγημένη: ποιος έγραψε τι, και πώς να το καταγράψετε
API Υγείας
Ιατρικός φάκελος ασθενούς
Δημιουργία εφαρμογής υγείας
Αναφορά API (OpenAPI) · Οδηγός γρήγορης εκκίνησης

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