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

Δημιουργία εφαρμογής υγειονομικής περίθαλψης

Οδηγός: χρησιμοποιήστε το Anpheros ως το backend ιατρικών δεδομένων μιας εφαρμογής υγειονομικής περίθαλψης — ασθενείς, μετρήσεις, καταστάσεις, φάρμακα, έγγραφα, εργαστηριακές εξετάσεις, συναίνεση, webhooks και SDKs.

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

Τι κατασκευάζετε

Μια τυπική εφαρμογή για ασθενείς — μια εφαρμογή παρακολούθησης χρόνιας πάθησης, μια εφαρμογή οικογενειακής υγείας, ένας σύντροφος απομακρυσμένης παρακολούθησης — χρειάζεται να:

διατηρεί ένα αρχείο ανά ασθενή: μετρήσεις, παθήσεις, φάρμακα, έγγραφα·
εμφανίζει αυτό το αρχείο ως λίστες και χρονοδιάγραμμα·
δέχεται δεδομένα από άλλες πηγές (συσκευές, εργαστήρια, κλινικές)·
μοιράζεται μέρη του αρχείου, με τη συγκατάθεση του ασθενούς·
αντιδρά όταν κάτι αλλάζει.

Με το Anpheros, η εφαρμογή σας διατηρεί τους δικούς της χρήστες, οθόνες και επιχειρησιακή λογική, και αναθέτει το ιατρικό αρχείο στην πλατφόρμα:

Mobile / web app ──► your backend ──► Anpheros Platform API ──► FHIR R4 record of each patient
                         ▲                                              │
                         └──────────── signed webhooks ◄────────────────┘

Το backend σας κατέχει το κλειδί API· η εφαρμογή επικοινωνεί με το backend σας. (Οι εφαρμογές που ενεργούν για έναν ασθενή που έχει ήδη αρχείο Anpheros χρησιμοποιούν OAuth αντ' αυτού — δείτε το βήμα 7.)

1. Λήψη κλειδιού sandbox

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

export BASE=https://platform.anpheros.com
export KEY=sk_test_…
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

2. Δημιουργία ασθενούς

Κάθε χρήστης της εφαρμογής σας αποκτά ένα αρχείο ασθενούς που ανήκει στο έργο σας.

curl -X POST $BASE/v1/patients -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -H "Idempotency-Key: $(uuidgen)" \
     -d '{"given": "Elena", "family": "Ionescu", "birth_date": "1985-09-03", "gender": "female"}'

Η απάντηση περιέχει τον ασθενή id (το δικό σας αναγνωριστικό για αυτό το άτομο — άλλα έργα βλέπουν ένα διαφορετικό) και την αναφορά fhir του.

3. Εγγραφή μετρήσεων, καταστάσεων και φαρμακευτικής αγωγής

Δηλώστε από ποιον προέρχονται τα δεδομένα με author_type: patient, practitioner, device, import ή ai. Αν το παραλείψετε, η πλατφόρμα καταγράφει import, ποτέ patient εξ ορισμού.

# a blood-pressure reading from a connected device (LOINC panel with two components)
curl -X POST $BASE/v1/patients/$PID/observations -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -H "Idempotency-Key: $(uuidgen)" -d '{
  "code": "85354-9", "display": "Blood pressure panel", "category": "vital-signs",
  "effective_at": "2026-09-28T08:00:00Z", "author_type": "device",
  "components": [
    {"code": "8480-6", "display": "Systolic", "value": 128, "unit": "mm[Hg]"},
    {"code": "8462-4", "display": "Diastolic", "value": 82, "unit": "mm[Hg]"}
  ]}'

# a diagnosis (ICD-10 by default)
curl -X POST $BASE/v1/patients/$PID/conditions -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"code": "I10", "display": "Essential hypertension", "onset": "2024-03-01", "author_type": "practitioner"}'

# a medication (ATC by default)
curl -X POST $BASE/v1/patients/$PID/medications -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"display": "Amlodipine 5 mg", "code": "C08CA01", "dosage": "1 tablet in the morning", "start": "2024-03-01", "author_type": "patient"}'

Κατηγορίες παρατήρησης: vital-signs, laboratory, symptom, activity, survey, exam, imaging, social-history. Κάθε εγγραφή αποθηκεύεται ως πόρος FHIR και λαμβάνει αυτόματα μια καταχώρηση Provenance.

4. Αποθήκευση εγγράφων

# create the document, then upload the bytes
curl -X POST $BASE/v1/patients/$PID/documents -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"title": "Blood tests 2026-09-14", "kind": "lab_report", "content_type": "application/pdf", "date": "2026-09-14"}'
curl -X PUT $BASE/v1/documents/$DOC/content -H "Authorization: Bearer $KEY" -H 'content-type: application/pdf' --data-binary @report.pdf

Το πρωτότυπο είναι αμετάβλητο μετά τη μεταφόρτωση· οι τιμές που εξάγετε από αυτό μπορούν να παραπέμπουν σε αυτό με derived_from.

5. Ανάγνωση του αρχείου καταγραφής

curl "$BASE/v1/patients/$PID/observations?category=vital-signs&limit=20" -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"   # everything, chronologically

Όταν χρειάζεστε το πλήρες μοντέλο FHIR, τα ίδια δεδομένα είναι διαθέσιμα στο /fhir/R4 με τα ίδια αναγνωριστικά (FHIR R4 API).

6. Σύνδεση εργαστηρίων και συσκευών

Εργαστηριακές αναφορές: POST /v1/patients/{id}/labs/import με CSV, HL7 v2 ORU^R01 ή JSON μετατρέπουν μια ολόκληρη αναφορά σε εργαστηριακές Παρατηρήσεις (Observations) με κωδικούς LOINC (Σύνδεση εργαστηρίου).
Συσκευές και wearables: γράψτε Παρατηρήσεις (Observations) με author_type: device και τον κωδικό LOINC της μέτρησης (καρδιακός ρυθμός, SpO₂, βήματα, διάρκεια ύπνου και άλλα αναφέρονται στα Συστήματα κωδικοποίησης FHIR).

7. Πρόσβαση σε υπάρχον αρχείο ασθενούς (OAuth)

Εάν το άτομο διατηρεί ήδη ένα αρχείο στο Anpheros (για παράδειγμα μέσω του Anpheros Daily), η εφαρμογή σας μπορεί να ζητήσει πρόσβαση αντί να δημιουργήσει νέο ασθενή: καταχωρήστε μια εφαρμογή, στείλτε το άτομο στη σελίδα συναίνεσης με τα scopes που χρειάζεστε, ανταλλάξτε τον κωδικό για tokens και καλέστε το API με το access token. Ο ασθενής επιλέγει τη διάρκεια και μπορεί να ανακαλέσει την πρόσβαση ανά πάσα στιγμή. Λεπτομέρειες: Authentication and OAuth.

8. Αντιδράστε σε αλλαγές με webhooks

curl -X POST $BASE/v1/webhooks -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"url": "https://your.app/anpheros/hook", "events": ["resource.created", "consent.revoked"]}'

Επαληθεύστε την κεφαλίδα Anpheros-Signature κάθε παράδοσης (Webhooks).

9. Χρήση ενός SDK

Η ίδια ροή σε TypeScript:

import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
const { data: patients } = await anpheros.patients.list();
const vitals = await anpheros.observations.list(patients[0].id, { category: 'vital-signs', limit: 20 });

Ένας πελάτης Dart / Flutter με το ίδιο σχήμα είναι διαθέσιμος ως anpheros_sdk (SDKs).

Πριν τη μετάβαση σε παραγωγή

Τα κλειδιά παραγωγής (sk_live_) εκδίδονται σε επαληθευμένους οργανισμούς με υπογεγραμμένη συμφωνία επεξεργασίας δεδομένων.
Διαβάστε τη σελίδα Ασφάλεια, απόρρητο και τοποθεσία δεδομένων και τα όρια.
Διαχειριστείτε τα σφάλματα ανά τύπο και αναφέρετε την κεφαλίδα Anpheros-Request-Id όταν επικοινωνείτε με την υποστήριξη (Σφάλματα).

Σχετικά

Πώς να δημιουργήσετε ένα API υγειονομικής περίθαλψης με TypeScript: οδηγός βήμα προς βήμα με Express
Πώς να δημιουργήσετε μια εφαρμογή υγειονομικής περίθαλψης με Flutter: οδηγός βήμα προς βήμα με το Dart SDK
Πώς να δημιουργήσετε μια εφαρμογή AI υγειονομικής περίθαλψης με backend FHIR: οδηγός βήμα προς βήμα σε TypeScript
Δημιουργήστε με Anpheros
Backend και βάση δεδομένων ιατρικών εφαρμογών
API ιατρικών δεδομένων
Ανάπτυξη λογισμικού υγειονομικής περίθαλψης
Πώς να δημιουργήσετε μια εφαρμογή προσωπικού ιατρικού φακέλου (PHR) με FHIR

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