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

API υγείας: τι είναι και πώς λειτουργεί

Τι είναι ένα API υγείας, πώς λειτουργεί μια κλήση, τι να προσέξετε, και ένα δωρεάν API υγείας FHIR R4 με συναίνεση ασθενούς, προέλευση και φιλοξενία στην ΕΕ — με παραδείγματα και FAQ.

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

Πώς λειτουργεί μια κλήση API υγειονομικής περίθαλψης

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

Είδη APIs υγειονομικής περίθαλψης

Το Anpheros συνδυάζει τα δύο πρώτα ως πυρήνα του, δέχεται αποτελέσματα εργαστηρίου HL7 v2 ως είσοδο, αποθηκεύει έγγραφα με τα πρωτότυπά τους και παράγει FHIR document bundles (το International Patient Summary). Προσφέρει επίσης ένα απλούστερο REST API πάνω στα ίδια δεδομένα για προγραμματιστές που δεν θέλουν να εργαστούν απευθείας με το FHIR.

Τι να αναζητήσετε σε ένα API υγειονομικής περίθαλψης

• Ένα τυπικό μοντέλο δεδομένων, ώστε τα δεδομένα να μπορούν να μετακινούνται μεταξύ συστημάτων χωρίς προσαρμοσμένη αντιστοίχιση.
• Εξουσιοδότηση που ελέγχει ο ασθενής, όχι μόνο διαπιστευτήρια που ελέγχει η εφαρμογή.
• Προέλευση (Provenance): ποιος έγραψε κάθε τιμή, για λογαριασμό ποιου, από ποιο σύστημα.
• Ιστορικό (History): εκδόσεις αντί για σιωπηλές αντικαταστάσεις.
• Ελεγξιμότητα (Auditability) των αναγνώσεων, όχι μόνο των εγγραφών.
• Ασφαλείς επαναδοκιμές (Safe retries) (ιδεοδυναμία - idempotency) και προβλέψιμα σφάλματα (predictable errors), επειδή τα δεδομένα υγείας δεν πρέπει να διπλασιάζονται ή να χάνονται.
• Απομόνωση (Isolation) μεταξύ των εφαρμογών που μοιράζονται την ίδια υποδομή.
• Διαμονή δεδομένων (Data residency) που ταιριάζει με την τοποθεσία των ασθενών.

Το υπόλοιπο αυτής της σελίδας δείχνει πώς εμφανίζεται καθένα από αυτά στο Anpheros API.

Η API του Anpheros με μια ματιά

Βασικό URL: https://platform.anpheros.com. Το sandbox και η παραγωγή μοιράζονται το ίδιο· το κλειδί καθορίζει το data plane.

Έλεγχος ταυτότητας

• Κλειδιά API (sk_test_…, sk_live_…) για τους διακομιστές σας· βλέπουν τους ασθενείς που δημιούργησε το έργο σας.
• Tokens πρόσβασης OAuth (at_…) για μια εφαρμογή που ενεργεί για έναν ασθενή υπό συναίνεση.

curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"

Ασφαλής εγγραφή

Τα αιτήματα POST δέχονται ένα Idempotency-Key: ένα επαναληφθέν αίτημα με το ίδιο κλειδί επιστρέφει την αρχική απόκριση και δεν δημιουργεί τίποτα. Κάθε εγγραφή λαμβάνει ένα Provenance· ο τύπος του συγγραφέα αποστέλλεται στο σώμα (author_type) ή σε κεφαλίδες όπως X-Anpheros-Author-Type, X-Anpheros-Source-System, X-Anpheros-Origin-Id και X-Anpheros-On-Behalf-Of.

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": "29463-7", "display": "Body weight", "category": "vital-signs",
          "value": 71.4, "unit": "kg", "effective_at": "2026-09-28T07:30:00Z", "author_type": "patient"}'

Σφάλματα και όρια

Οι τελικοί κόμβοι FHIR απαντούν με OperationOutcome· οι υπόλοιποι με {"error": {"type", "message", "field"}}. Κάθε απόκριση φέρει Anpheros-Request-Id. Το προεπιλεγμένο όριο είναι 600 αιτήματα ανά λεπτό ανά κλειδί και ανά IP. Σφάλματα · Όρια

Γεγονότα

Υπογεγραμμένα webhooks για resource.created, resource.updated, resource.deleted, consent.granted, consent.revoked, document.finalized και ping. Webhooks

Επιλογή μεταξύ FHIR και REST v1

Χρησιμοποιήστε το FHIR όταν ήδη εργάζεστε με FHIR, χρειάζεστε τύπους πόρων που το /v1 δεν καλύπτει (για παράδειγμα Immunization, Procedure ή CarePlan), ή ανταλλάσσετε δεδομένα με άλλα συστήματα FHIR. Χρησιμοποιήστε το REST v1 για κώδικα εφαρμογής που θέλει επίπεδο JSON για τις κοινές περιπτώσεις. Και τα δύο διαβάζουν και γράφουν τους ίδιους πόρους με τα ίδια αναγνωριστικά, οπότε ένα έργο μπορεί να τα συνδυάσει. Το Medical data API περιγράφει τις λειτουργίες δεδομένων λεπτομερώς.

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

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

Μια προγραμματική διεπαφή μέσω της οποίας το λογισμικό διαβάζει και γράφει δεδομένα υγείας — αρχεία ασθενών, παρατηρήσεις, διαγνώσεις, φάρμακα και έγγραφα — και μέσω της οποίας εξουσιοδοτείται η πρόσβαση σε αυτά τα δεδομένα. Τα σύγχρονα API υγειονομικής περίθαλψης χρησιμοποιούν HL7 FHIR R4 για τα δεδομένα και OAuth 2.0 ή 2.1 με SMART on FHIR για την εξουσιοδότηση.

Ποια είναι η διαφορά μεταξύ ενός API υγειονομικής περίθαλψης και ενός FHIR API;

Το FHIR είναι ένα πρότυπο που μπορεί να ακολουθήσει ένα API υγειονομικής περίθαλψης. Ένα FHIR API ανταλλάσσει πόρους FHIR μέσω REST· ένα API υγειονομικής περίθαλψης μπορεί επίσης να δέχεται μηνύματα HL7 v2, έγγραφα ή ιδιόκτητο JSON. Το Anpheros προσφέρει ένα API FHIR R4 και ένα απλούστερο REST API πάνω στα ίδια δεδομένα.

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

Ναι. Το sandbox του Anpheros είναι δωρεάν και αυτοεξυπηρετούμενο: συνδεθείτε με το Google, αποκτήστε ένα κλειδί API και εργαστείτε με 30 συνθετικούς ασθενείς μέσω FHIR R4 ή REST. Η παραγωγή ξεκινά από 99 € το μήνα, με τον πρώτο μήνα δωρεάν.

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

Μέσω OAuth 2.1 με PKCE: η εφαρμογή στέλνει το άτομο σε μια σελίδα συγκατάθεσης με SMART on FHIR scopes· το άτομο επιλέγει τι θα μοιραστεί και για πόσο χρονικό διάστημα, μπορεί να δει ένα αρχείο καταγραφής πρόσβασης και μπορεί να ανακαλέσει την πρόσβαση ανά πάσα στιγμή.

Πού αποθηκεύονται τα δεδομένα;

Στην Ευρωπαϊκή Ένωση: η υπηρεσία και οι βάσεις δεδομένων της εκτελούνται στο Google Cloud europe-west4 (Ολλανδία).

Ποιο API υγειονομικής περίθαλψης πρέπει να επιλέξω;

Συγκρίνετε το πρότυπο δεδομένων, ποιος εξουσιοδοτεί την πρόσβαση, την προέλευση και τον έλεγχο, την τοποθεσία των δεδομένων, πώς συμπεριφέρονται οι επαναπροσπάθειες και τα σφάλματα, και αν μπορείτε να δοκιμάσετε με ρεαλιστικά δεδομένα δωρεάν. Το Πλατφόρμα API υγειονομικής περίθαλψης: τι περιλαμβάνει και πώς να επιλέξετε μετατρέπει αυτά σε ερωτήσεις που πρέπει να κάνετε σε οποιονδήποτε προμηθευτή.

Σχετικά

• EHR API και API ιατρικών αρχείων
• Πλατφόρμα Healthcare API: τι περιλαμβάνει και πώς να επιλέξετε
• Πώς να δημιουργήσετε ένα Healthcare API με TypeScript: οδηγός βήμα προς βήμα με Express
• Πώς να αποθηκεύσετε ιατρικά αρχεία χρησιμοποιώντας FHIR R4: οδηγός βήμα προς βήμα με curl
• Healthcare API με συναίνεση ασθενούς
• SMART on FHIR backend
• API ιατρικών δεδομένων
• Πλατφόρμα FHIR
• Διαλειτουργικότητα δεδομένων υγειονομικής περίθαλψης
• Ενσωματώσεις υγειονομικής περίθαλψης
• Αναφορά API (OpenAPI) · Έλεγχος ταυτότητας και OAuth

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