Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
SDKs
Οι πελάτες Dart / Flutter (anpheros_sdk) και TypeScript (@anpheros/sdk): ίδια δομή, ατομικές δημιουργίες, επαναπροσπάθειες, ανανέωση token και ροή συναίνεσης.
Επίσημες client βιβλιοθήκες για ένα FHIR R4 healthcare API με δωρεάν FHIR sandbox: ασθενείς, παρατηρήσεις, εργαστηριακά αποτελέσματα, καταστάσεις, φάρμακα, International Patient Summary, συναίνεση ασθενούς και AI context, σε TypeScript και Dart / Flutter.
Η Anpheros είναι μια διαλειτουργική υποδομή ιατρικών δεδομένων για τη δημιουργία εφαρμογών υγειονομικής περίθαλψης, ιατρικού λογισμικού και υπηρεσιών AI. Κάθε ασθενής έχει ένα HL7 FHIR R4 record που ελέγχει. οι εφαρμογές, οι κλινικές, τα εργαστήρια και οι AI agents το διαβάζουν και το γράφουν μέσω του Anpheros Platform API — με τη συναίνεση του ασθενούς (OAuth 2.1 / SMART on FHIR), provenance σε κάθε εγγραφή και ένα αρχείο καταγραφής πρόσβασης που μπορεί να δει ο ασθενής. Αυτό το repository περιέχει τις επίσημες client βιβλιοθήκες και εκτελέσιμα παραδείγματα.
| Γλώσσα | Package | Εγκατάσταση | Πηγή |
|---|---|---|---|
| Dart / Flutter | anpheros_sdk |
dart pub add anpheros_sdk |
dart/anpheros_sdk |
| TypeScript (Node 18+, browsers, Deno, Bun) | @anpheros/sdk |
npm install @anpheros/sdk |
ts |
Γρήγορη εκκίνηση σε 2 λεπτά
- Λάβετε ένα δωρεάν κλειδί sandbox: συνδεθείτε στο dashboard και πατήστε Get a sandbox key (
sk_test_…). Το sandbox σας έχει 30 συνθετικούς ασθενείς. - Ελέγξτε ότι λειτουργεί:
bash
curl -H "Authorization: Bearer $ANPHEROS_KEY" "https://platform.anpheros.com/fhir/R4/Patient?_count=3"
- Εγκαταστήστε ένα SDK και διαβάστε ένα αρχείο καταγραφής:
npm install @anpheros/sdkήdart pub add anpheros_sdk, στη συνέχεια εκτελέστε τον κώδικα στην ενότητα Connect, ή κάντε clone το quickstart-ts.
Για ποιον προορίζεται
Για προγραμματιστές που δημιουργούν εφαρμογές υγείας ασθενών και οικογένειας, backends ιατρικών εφαρμογών, ενσωματώσεις κλινικών και εργαστηρίων, και βοηθούς ή πράκτορες AI που χρειάζονται δομημένο ιατρικό πλαίσιο ασθενούς — χωρίς να χρειάζεται να σχεδιάσουν από την αρχή μια ιατρική βάση δεδομένων, ένα σύστημα συναίνεσης και ένα αρχείο καταγραφής ελέγχου.
Λήψη κλειδιού sandbox
Το sandbox είναι δωρεάν και αυτοεξυπηρετούμενο. Συνδεθείτε με τον λογαριασμό σας Google στον πίνακα ελέγχου και πατήστε Λήψη κλειδιού sandbox: θα λάβετε άμεσα ένα έργο sandbox και ένα κλειδί. Κάθε έργο sandbox συνοδεύεται από 30 συνθετικούς ασθενείς — έξι μήνες δεδομένων για καταστάσεις, φαρμακευτική αγωγή, αλλεργίες, εργαστηριακά αποτελέσματα και ζωτικά σημεία — τους οποίους μπορείτε να τροποποιήσετε ελεύθερα και να επαναφέρετε ανά πάσα στιγμή. Τα κλειδιά sandbox (sk_test_…) δεν αποκτούν ποτέ πρόσβαση σε πραγματικά δεδομένα ασθενών.
Όταν μεταβείτε σε παραγωγική λειτουργία, η παραγωγή απευθύνεται σε επαληθευμένους οργανισμούς με συμφωνία επεξεργασίας δεδομένων, και η παραγωγή ξεκινά από 99 € το μήνα με τον πρώτο μήνα δωρεάν (τιμολόγηση).
Σύνδεση
import { Anpheros, apiKey } from '@anpheros/sdk';
const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) }); // sk_test_… in the sandbox
const { data: patients } = await anpheros.patients.list();
const labs = await anpheros.observations.list(patients[0].id, { category: 'laboratory', limit: 10 });
const ctx = await anpheros.context.build({ patient: patients[0].id, task: 'weekly check-in', budget_tokens: 1500, format: 'text' });
import 'package:anpheros_sdk/anpheros_sdk.dart';
final anpheros = Anpheros(auth: AnpherosAuth.apiKey('sk_test_…'));
final patients = await anpheros.patients.list();
final labs = await anpheros.observations.list(patients.data.first.id, category: 'laboratory', limit: 10);
Τα κλειδιά API ανήκουν σε διακομιστές. Μια εφαρμογή που ενεργεί για λογαριασμό ενός ατόμου χρησιμοποιεί OAuth αντ' αυτού: και τα δύο SDK υλοποιούν τη ροή συναίνεσης (κωδικός εξουσιοδότησης + PKCE) και ανανεώνουν αυτόματα τα διακριτικά ανανέωσης.
Τι καλύπτουν τα SDKs
Και τα δύο καλύπτουν ολόκληρη τη δημόσια επιφάνεια (/v1, /fhir/R4, /oauth/token, /oauth/revoke) με το
ίδιο σχήμα: patients, observations, conditions, medications, documents, timeline,
provenance, context, grants, terminology και raw fhir. Μια δοκιμή αποτυγχάνει
την κατασκευή όταν μια δημόσια διαδρομή λείπει από οποιοδήποτε SDK ή όταν ένα SDK καλεί μια διαδρομή που ο διακομιστής
δεν διαθέτει.
Και τα δύο SDKs: αυτόματη Idempotency-Key στις δημιουργίες, επαναδοκιμές με backoff σε 429/5xx, ανανέωση ενός token
σε 401, τυποποιημένα σφάλματα με το αναγνωριστικό αιτήματος, βοηθητικά προγράμματα PKCE και τη ροή συναίνεσης.
Ιατρικά δεδομένα και FHIR
Το αρχείο αποτελείται από τυπικούς πόρους FHIR R4 — 26 τύπους, συμπεριλαμβανομένων των Observation, Condition, MedicationStatement, DocumentReference, Immunization και AllergyIntolerance — κωδικοποιημένους με LOINC, ICD-10, ATC και UCUM. Το REST API (/v1) και το FHIR API (/fhir/R4) διαβάζουν και γράφουν τους ίδιους πόρους με τα ίδια αναγνωριστικά. Η fhir και στα δύο SDKs παρέχει απευθείας πρόσβαση σε FHIR (αναζήτηση, συναλλαγές, $everything, $summary, $validate).
Παραδείγματα
| Παράδειγμα | Εμφανίζει |
|---|---|
| quickstart-ts | εγγραφή και ανάγνωση ενός record: μετρήσεις, εργαστηριακό αποτέλεσμα, διάγνωση, φαρμακευτική αγωγή, χρονοδιάγραμμα, αναζήτηση FHIR, IPS, AI context |
| quickstart-dart | το ίδιο από Dart / Flutter |
| consent-app-ts | μια web εφαρμογή που ζητά συναίνεση (OAuth 2.1 + PKCE) και διαβάζει το record του ατόμου |
| ai-context-llm | μια ερώτηση σχετικά με ένα record που απαντάται από ένα μοντέλο της επιλογής σας (τοπικό ή φιλοξενούμενο) |
| fhir-transaction | ένα FHIR R4 transaction bundle και το προκύπτον International Patient Summary |
Τα παραδείγματα εκτελούνται στο δωρεάν sandbox, όπου κάθε sandbox project έχει τους δικούς του 30 συνθετικούς ασθενείς — δείτε Λήψη κλειδιού sandbox.
Σχετικά αποθετήρια
| Αποθετήριο | Τι είναι |
|---|---|
| fhir-api-openapi | OpenAPI 3.1 spec και Postman collection του API |
| mcp-server | ο φιλοξενούμενος FHIR MCP server για AI agents: configs για Claude, Cursor, VS Code |
| agent-skills | Agent Skill, Claude Code plugin, Cursor rules και AGENTS.md |
| fhir-synthetic-patients | οι 30 συνθετικοί ασθενείς ως FHIR R4 Bundles και NDJSON |
| ips-examples | Έγγραφα International Patient Summary σε FHIR R4 |
| fhir-validate-action | GitHub Action που επικυρώνει FHIR R4 JSON σε CI |
| lab-results-to-fhir | CLI: CSV / HL7 v2 αναφορές εργαστηρίου → FHIR Observations |
| healthcare-app-starters | Πρότυπα εφαρμογών υγείας Next.js και Flutter |
Συμμόρφωση
Ακατέργαστα αποτελέσματα δοκιμών, δημοσιευμένα ώστε να μπορούν να ελεγχθούν (αποτελέσματα δοκιμών, όχι πιστοποιήσεις): conformance/. Στις 28 Σεπτεμβρίου 2026, η ομάδα Standalone Launch του κιτ δοκιμών Inferno SMART App Launch STU2 (v1.0.3) πέρασε 22 από 22 δοκιμές έναντι της πλατφόρμας. Η εκκίνηση EHR δεν υποστηρίζεται.
Τεκμηρίωση
- Οδηγοί προγραμματιστών
- Ξεκινώντας
- FHIR sandbox
- Healthcare API
- Healthcare API platform
- FHIR platform
- Οδηγός SDK
- Αναφορά API (OpenAPI)
- Για βοηθούς AI
- Anpheros
Θέματα και ασφάλεια
Αναφέρετε σφάλματα στα θέματα (issues) αυτού του αποθετηρίου. Ποτέ μην συμπεριλαμβάνετε κλειδιά API, tokens ή δεδομένα ασθενών σε ένα θέμα. Αναφορές ασφαλείας: [email protected].
Άδεια χρήσης
Apache License 2.0 — δείτε το αρχείο LICENSE κάθε πακέτου. Copyright 2026 Anpheros.
@anpheros/sdk
TypeScript client για την Anpheros Platform: ένα FHIR R4 health record ανά ασθενή, απομόνωση έργου, συναίνεση ασθενούς (OAuth 2.1 / SMART on FHIR), προέλευση σε κάθε εγγραφή και ένα AI context API. Τρέχει οπουδήποτε υπάρχει fetch (Node 18+, browsers, Deno, Bun).
import { Anpheros, apiKey } from '@anpheros/sdk';
const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
const { data: patients } = await anpheros.patients.list();
const labs = await anpheros.observations.list(patients[0].id, { category: 'laboratory', limit: 10 });
const ctx = await anpheros.context.build({ patient: patients[0].id, task: 'weekly check-in', budget_tokens: 1500, format: 'text' });
Ενέργεια για ένα άτομο:
import { OAuthFlow, OAuthAuth, generatePkce } from '@anpheros/sdk';
const flow = new OAuthFlow({ baseUrl: BASE, clientId: 'client_…', redirectUri: 'https://myapp.example/callback' });
const pkce = await generatePkce();
location.href = flow.authorizeUrl({ scopes: ['patient/Observation.rs?category=laboratory', 'offline_access'], state, pkce, lang: 'ro' });
// on the callback:
const tokens = await flow.exchange(code, pkce);
const anpheros = new Anpheros({ auth: new OAuthAuth({ tokens, onRefresh: flow.refresh, onTokens: persist }) });
Τα σφάλματα είναι AnpherosError (status, type, message, field, requestId). Οι δημιουργίες στέλνουν ένα Idempotency-Key. Τα 429/5xx επαναλαμβάνονται. Τα ληγμένα tokens ανανεώνονται μία φορά και η κλήση επαναλαμβάνεται.
anpheros_sdk
Dart / Flutter client για την Anpheros Platform: ένα backend υγείας με FHIR R4 record ανά ασθενή, απομόνωση έργων, συναίνεση ασθενούς (OAuth 2.1 / SMART on FHIR), προέλευση σε κάθε εγγραφή και ένα AI context API.
import 'package:anpheros_sdk/anpheros_sdk.dart';
final anpheros = Anpheros(auth: AnpherosAuth.apiKey('sk_test_…')); // server / sandbox
final patients = await anpheros.patients.list();
final elena = patients.data.first;
final labs = await anpheros.observations.list(elena.id, category: 'laboratory', limit: 10);
final ctx = await anpheros.context.build(ContextRequest(patient: elena.id, task: 'weekly check-in', budgetTokens: 1500));
Ενέργεια για λογαριασμό ατόμου (εφαρμογές)
final flow = OAuthFlow(baseUrl: 'https://…', clientId: 'client_…', redirectUri: 'myapp://callback');
final pkce = Pkce.generate();
final url = flow.authorizeUrl(scopes: ['patient/Observation.rs?category=laboratory', 'patient/MedicationStatement.r', 'offline_access'],
state: 'abc', pkce: pkce, lang: 'ro');
// open `url`; on return with ?code=…:
final tokens = await flow.exchange(code: code, pkce: pkce);
final anpheros = Anpheros(auth: AnpherosAuth.oauth(
accessToken: tokens.accessToken, refreshToken: tokens.refreshToken, expiresAt: tokens.expiresAt,
onRefresh: flow.refresh, onTokens: persist));
final meds = await anpheros.medications.listMedications(tokens.patient!);
Κάθε αντικείμενο φέρει fhir (τη /fhir/R4 αναφορά του); η anpheros.fhir παρέχει απευθείας πρόσβαση FHIR
(read, search, create, transaction, $everything, $summary, $validate).
Τα σφάλματα AnpherosException με status, type, message, field και requestId.
Οι δημιουργίες στέλνουν αυτόματα ένα Idempotency-Key. τα 429/5xx επαναλαμβάνονται με backoff. τα ληγμένα OAuth
tokens ανανεώνονται μία φορά και η κλήση επαναλαμβάνεται.
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card