API δεδομένων υγείας: τι να προσέξετε, και πώς να διαβάσετε και να γράψετε ένα ιατρικό αρχείο σε μία ώρα

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

Τεχνική έκδοση για προγραμματιστές: API Υγειονομικής Περίθαλψης · API Ιατρικών Δεδομένων στο developers.anpheros.com, με αιτήματα, απαντήσεις και όρια. Αυτή η σελίδα είναι η έκδοση απλής γλώσσας.

Τι πρέπει να κάνει ένα API δεδομένων υγειονομικής περίθαλψης

Πέντε πράγματα διαχωρίζουν ένα χρησιμοποιήσιμο API δεδομένων υγείας από μια βάση δεδομένων με HTTP μπροστά της.

• Τυπική μορφή. Το HL7 FHIR R4 είναι η μορφή που χρησιμοποιούν τα νοσοκομεία, τα εθνικά συστήματα και ο χώρος δεδομένων υγείας της ΕΕ. Ένα αρχείο που αποθηκεύεται σε FHIR μπορεί να διαβαστεί από άλλα συστήματα χωρίς προσαρμοσμένη γέφυρα. Ένα ιδιόκτητο JSON δεν μπορεί.
• Συναίνεση ασθενούς ως αντικείμενο πρώτης κατηγορίας. Ποιος μπορεί να διαβάσει τι, για πόσο καιρό, ανακλητό, ορατό στον ασθενή. Όχι ένα κουτάκι ελέγχου στη δική σας βάση δεδομένων.
• Προέλευση. Κάθε τιμή λέει ποιος την έγραψε: ο ασθενής, ένας επαγγελματίας υγείας, μια συσκευή, μια εισαγωγή, ένας υπολογισμός που προέκυψε. Ένας βοηθός τεχνητής νοημοσύνης που δεν μπορεί να διακρίνει ένα εργαστηριακό αποτέλεσμα από μια αυτο-αναφερόμενη εικασία είναι επικίνδυνος.
• Sandbox με ρεαλιστικά δεδομένα. Δεν μπορείτε να δοκιμάσετε με πραγματικούς ασθενείς, και δεν θα έπρεπε να χρειάζεται να επινοήσετε μόνοι σας 30 συνθετικούς με ιστορικό έξι μηνών.
• Διαμονή δεδομένων που μπορείτε να ονομάσετε. Για Ευρωπαίους χρήστες αυτό σημαίνει διακομιστές στην ΕΕ, υπό GDPR, με συμφωνία επεξεργασίας δεδομένων.

Δύο τρόποι εισόδου: REST και FHIR, ίδια δεδομένα

Η Πλατφόρμα Anpheros εκθέτει το ίδιο αρχείο δύο φορές. Ένα απλό API REST (/v1) για κωδικό προϊόντος, και αυστηρό FHIR R4 (/fhir/R4) για οτιδήποτε πρέπει να επικοινωνεί με το υπόλοιπο σύστημα υγείας. Τα αναγνωριστικά είναι πανομοιότυπα και στα δύο. κάθε αντικείμενο v1 φέρει την αναφορά fhir του.

export BASE=https://platform.anpheros.com
export KEY=sk_test_…

# ασθενείς που μπορεί να δει το έργο σας
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# εργαστηριακά αποτελέσματα, νεότερα πρώτα
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# ενεργά φάρμακα
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# τα πάντα σε ένα χρονοδιάγραμμα
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# τα ίδια δεδομένα, αυστηρό FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

Πίσω από αυτές τις κλήσεις βρίσκονται 26 τύποι πόρων FHIR (Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance και άλλοι), κωδικοποιημένοι με LOINC για μετρήσεις, ICD-10 για παθήσεις και ATC για φάρμακα.

Η απόκτηση κλειδιού διαρκεί ένα λεπτό

Το sandbox είναι αυτοεξυπηρετούμενο και δωρεάν. Συνδεθείτε στον πίνακα ελέγχου στο platform.anpheros.com/dashboard, πατήστε Λήψη κλειδιού sandbox, και έχετε έναν οργανισμό, ένα έργο sandbox και ένα κλειδί sk_test_…. Το έργο έρχεται με τη δική του αντιγραφή 30 συνθετικών ασθενών: ενήλικες, παιδιά και ηλικιωμένους από όλη την ΕΕ, με παθήσεις, φάρμακα, αλλεργίες, εργαστηριακά αποτελέσματα και ζωτικά σημεία για έξι μήνες. Αλλάξτε ή διαγράψτε οτιδήποτε. μια επαναφορά τα φέρνει πίσω.

Τα κλειδιά παραγωγής (sk_live_…) πηγαίνουν σε επαληθευμένους οργανισμούς με υπογεγραμμένη συμφωνία επεξεργασίας δεδομένων. Το sandbox και η παραγωγή είναι διαφορετικές βάσεις δεδομένων: ένα κλειδί sandbox φυσικά δεν μπορεί να φτάσει σε πραγματικό ασθενή.

Τι άλλο υπάρχει στο πακέτο

• OAuth 2.1 με PKCE και αυτόνομη εκκίνηση SMART on FHIR, ώστε μια εφαρμογή να μπορεί να ζητήσει από ένα άτομο πρόσβαση στο δικό του αρχείο.
• Συναίνεση με πεδία, λήξη και ανάκληση, και αρχείο πρόσβασης που μπορεί να διαβάσει ο ασθενής.
• Υπογεγραμμένα webhooks (HMAC-SHA256, με επαναδοκιμές με backoff) για resource.created, consent.granted, consent.revoked, document.finalized.
• API τεχνητής νοημοσύνης για περιεχόμενο που δημιουργεί μια περίληψη ενός ασθενούς με ετικέτες προέλευσης εντός ενός προϋπολογισμού token.
• Εισαγωγή εργαστηριακών αναφορών από CSV, HL7 v2 ORU^R01 ή JSON, αντιστοιχισμένη σε LOINC.
• Διεθνής Περίληψη Ασθενούς ($summary) και SMART Health Links για κοινή χρήση μέσω QR.
• SDKs για Dart και TypeScript, μια αναφορά OpenAPI στο /docs και ένα CapabilityStatement στο /fhir/R4/metadata.

Η πλήρης αναλυτική παρουσίαση, με τις απαντήσεις, βρίσκεται στο developers.anpheros.com/guides/first-hour.

Συχνές ερωτήσεις

Υπάρχει δωρεάν API υγειονομικής περίθαλψης με το οποίο μπορώ να ξεκινήσω σήμερα;

Ναι. Το sandbox της Anpheros είναι δωρεάν και αυτοεξυπηρετούμενο: συνδεθείτε, λάβετε ένα κλειδί και έχετε 30 συνθετικούς ασθενείς για να διαβάζετε και να γράφετε. Τα όρια είναι 10.000 εγγραφές πόρων την ημέρα, 100 δικοί σας ασθενείς και 250 MB εγγράφων ανά έργο.

REST ή FHIR, ποιο να χρησιμοποιήσω;

Χρησιμοποιήστε το /v1 για τον δικό σας κωδικό προϊόντος: είναι απλούστερο και επιστρέφει απλό JSON. Χρησιμοποιήστε το /fhir/R4 όταν ένα άλλο σύστημα πρέπει να διαβάσει τα δεδομένα, όταν χρειάζεστε αναζήτηση FHIR, _history, $everything ή $summary, ή όταν μια πιστοποίηση το ζητάει. Και τα δύο βλέπουν το ίδιο αρχείο.

Πώς διαχειρίζεται η συναίνεση του ασθενούς;

Ένα άτομο χορηγεί σε μια εφαρμογή πρόσβαση στο αρχείο του μέσω OAuth, επιλέγοντας πεδία και διάρκεια (30, 90, 180 ή 365 ημέρες). Η χορήγηση μπορεί να ανακληθεί ανά πάσα στιγμή, και ο ασθενής βλέπει κάθε ανάγνωση σε ένα αρχείο πρόσβασης. Λεπτομέρειες στο μοντέλο συναίνεσης.

Πού φιλοξενούνται τα δεδομένα;

Στην Ευρωπαϊκή Ένωση (Cloud Run, europe-west4), με προέλευση και ιστορικό εκδόσεων σε κάθε εγγραφή. Η χρήση παραγωγής απαιτεί υπογεγραμμένη συμφωνία επεξεργασίας δεδομένων.

Τι κοστίζει η παραγωγή;

Η παραγωγή ξεκινά από 49 € το μήνα για 2.500 αποθηκευμένους ασθενείς, με τον πρώτο μήνα δωρεάν. Μεγαλύτερα πακέτα κοστίζουν 199 € και 799 € το μήνα. Το sandbox παραμένει δωρεάν. Δείτε τιμολόγηση.

Λειτουργεί με πράκτορες τεχνητής νοημοσύνης;

Ναι. Υπάρχει ένα API τεχνητής νοημοσύνης για περιεχόμενο με ετικέτες προέλευσης και προϋπολογισμό token, και ένας διακομιστής MCP στο platform.anpheros.com/mcp στον οποίο μπορεί να συνδεθεί οποιοσδήποτε βοηθός με δυνατότητα MCP. Δείτε Ενσωμάτωση EMR με βοηθούς ιατρικής τεχνητής νοημοσύνης.