Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
SDK-k
A Dart / Flutter (anpheros_sdk) és TypeScript (@anpheros/sdk) kliensek: azonos struktúra, idempotens létrehozás, újrapróbálkozások, tokenfrissítés és a hozzájárulási folyamat.
Hivatalos klienskönyvtárak egy FHIR R4 egészségügyi API-hoz ingyenes FHIR sandbox-szal: betegek, megfigyelések, laboreredmények, állapotok, gyógyszerek, Nemzetközi Betegösszefoglaló, beteg hozzájárulás és AI kontextus, TypeScript és Dart / Flutter nyelven.
Az Anpheros egy interoperábilis orvosi adat infrastruktúra egészségügyi alkalmazások, orvosi szoftverek és AI szolgáltatások építéséhez. Minden beteg rendelkezik egy HL7 FHIR R4 rekorddal, amelyet ő irányít; az alkalmazások, klinikák, laboratóriumok és AI ügynökök ezt az Anpheros Platform API-n keresztül olvassák és írják – beteg hozzájárulással (OAuth 2.1 / SMART on FHIR), minden íráshoz származási információval és egy hozzáférési naplóval, amelyet a beteg láthat. Ez a repository tartalmazza a hivatalos klienskönyvtárakat és futtatható példákat.
| Nyelv | Csomag | Telepítés | Forrás |
|---|---|---|---|
| Dart / Flutter | anpheros_sdk |
dart pub add anpheros_sdk |
dart/anpheros_sdk |
| TypeScript (Node 18+, böngészők, Deno, Bun) | @anpheros/sdk |
npm install @anpheros/sdk |
ts |
Gyorsindítás 2 perc alatt
- Szerezzen ingyenes sandbox kulcsot: jelentkezzen be a dashboard oldalon, és nyomja meg a Get a sandbox key (
sk_test_…) gombot. A sandbox 30 szintetikus beteget tartalmaz. - Ellenőrizze, hogy működik-e:
bash
curl -H "Authorization: Bearer $ANPHEROS_KEY" "https://platform.anpheros.com/fhir/R4/Patient?_count=3"
- Telepítsen egy SDK-t és olvasson el egy rekordot:
npm install @anpheros/sdkvagydart pub add anpheros_sdk, majd futtassa a kódot a Connect alatt, vagy klónozza a quickstart-ts repót.
Kiknek szól
Fejlesztőknek, akik beteg- és családbarát egészségügyi alkalmazásokat, orvosi alkalmazások backendjeit, klinikai és laboratóriumi integrációkat, valamint mesterséges intelligencia asszisztenseket vagy ügynököket fejlesztenek, amelyeknek strukturált betegkontextusra van szükségük – anélkül, hogy orvosi adatbázist, hozzájárulási rendszert és audit trail-t kellene a nulláról tervezniük.
Sandbox kulcs igénylése
A sandbox ingyenes és önkiszolgáló. Jelentkezzen be a Google-lal a dashboardon, és nyomja meg a Get a sandbox key gombot: azonnal kap egy sandbox projektet és egy kulcsot. Minden sandbox projekthez 30 szintetikus páciens tartozik – hat hónapnyi állapot, gyógyszerelés, allergia, laboreredmény és életjel –, amelyeket szabadon módosíthat és bármikor visszaállíthat. A sandbox kulcsok (sk_test_…) soha nem érnek el valós páciensadatokat.
Élesben a termelés a hitelesített szervezetek számára elérhető, adatfeldolgozási megállapodással, és a termelés havi 49 eurótól indul, az első hónap ingyenes (pricing).
Csatlakozás
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);
Az API kulcsok szervereken tárolandók. Egy személy nevében eljáró alkalmazás ehelyett OAuth-ot használ: mindkét SDK megvalósítja a hozzájárulási folyamatot (authorization code + PKCE) és automatikusan frissíti a tokeneket.
Amit az SDK-k lefednek
Mindkettő lefedik a teljes nyilvános felületet (/v1, /fhir/R4, /oauth/token, /oauth/revoke) ugyanazzal az alakzattal: patients, observations, conditions, medications, documents, timeline, provenance, context, grants, terminology és nyers fhir. Egy teszt megbuktatja a buildet, ha egy nyilvános útvonal hiányzik valamelyik SDK-ból, vagy ha egy SDK olyan útvonalat hív meg, amivel a szerver nem rendelkezik.
Mindkét SDK: automatikus Idempotency-Key create műveleteknél, újrapróbálkozás backoff-al 429/5xx hibák esetén, egy token frissítés 401 esetén, típusos hibák a request id-vel, PKCE segédletek és a hozzájárulási folyamat.
Orvosi adatok és FHIR
A rekord standard FHIR R4 erőforrásokból áll – 26 típus, beleértve a Observation, Condition, MedicationStatement, DocumentReference, Immunization és AllergyIntolerance erőforrásokat – LOINC, ICD-10, ATC és UCUM kódokkal. A REST API (/v1) és a FHIR API (/fhir/R4) ugyanazokat az erőforrásokat olvassa és írja ugyanazokkal az azonosítókkal; fhir mindkét SDK-ban nyers FHIR hozzáférést biztosít (keresés, tranzakciók, $everything, $summary, $validate).
Példák
| Példa | Bemutatja |
|---|---|
| quickstart-ts | rekord írása és olvasása: mérések, laboreredmény, diagnózis, gyógyszer, idővonal, FHIR keresés, IPS, AI kontextus |
| quickstart-dart | ugyanez Dart / Flutter nyelven |
| consent-app-ts | egy webalkalmazás, amely hozzájárulást kér (OAuth 2.1 + PKCE) és elolvassa a személy rekordját |
| ai-context-llm | egy rekordról szóló kérdés, amelyre egy Ön által választott modell válaszol (helyi vagy hosztolt) |
| fhir-transaction | egy FHIR R4 tranzakciós csomag és az eredményül kapott International Patient Summary |
A példák az ingyenes sandbox ellen futnak, ahol minden sandbox projektnek saját 30 szintetikus betege van – lásd: Szerezzen sandbox kulcsot.
Kapcsolódó adattárak
| Adattár | Mi ez? |
|---|---|
| fhir-api-openapi | Az API OpenAPI 3.1 specifikációja és Postman gyűjteménye |
| mcp-server | A hosztolt FHIR MCP szerver AI ügynökök számára: konfigurációk Claude, Cursor, VS Code számára |
| agent-skills | Agent Skill, Claude Code plugin, Cursor szabályok és AGENTS.md |
| fhir-synthetic-patients | A 30 szintetikus beteg FHIR R4 Bundles és NDJSON formátumban |
| ips-examples | Nemzetközi Betegösszefoglaló dokumentumok FHIR R4 formátumban |
| fhir-validate-action | GitHub Action, amely validálja az FHIR R4 JSON-t CI-ben |
| lab-results-to-fhir | CLI: CSV / HL7 v2 laborjelentések → FHIR megfigyelések |
| healthcare-app-starters | Next.js és Flutter egészségügyi alkalmazás sablonok |
Megfelelőség
Nyers teszteredmények, közzétéve, hogy ellenőrizhetők legyenek (teszteredmények, nem minősítések): conformance/. 2026. szeptember 28-án az Inferno SMART App Launch STU2 tesztkészlet (v1.0.3) Standalone Launch csoportja 22-ből 22 tesztet teljesített a platform ellen. EHR indítás nem támogatott.
Dokumentáció
- Fejlesztői útmutatók
- Első lépések
- FHIR sandbox
- Healthcare API
- Healthcare API platform
- FHIR platform
- SDK útmutató
- API referencia (OpenAPI)
- AI asszisztenseknek
- Anpheros
Issues és biztonság
Jelentse a hibákat a repository issues részében. Soha ne tartalmazzon API kulcsokat, tokeneket vagy páciens adatokat egy issue-ban. Biztonsági jelentések: [email protected].
Licenc
Apache License 2.0 — lásd a LICENSE fájlt minden csomagban. Copyright 2026 Anpheros.
@anpheros/sdk
TypeScript kliens a Anpheros Platform-hoz: FHIR R4 alapú egészségügyi rekord betegre lebontva, projekt izoláció, beteg hozzájárulás (OAuth 2.1 / SMART on FHIR), minden íráshoz származási információ, és egy AI kontextus API. Bárhol fut fetch, ahol létezik (Node 18+, böngészők, 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' });
Személy nevében eljárva:
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 }) });
A hibák AnpherosError (status, type, message, field, requestId). A létrehozások Idempotency-Key küldenek; a 429/5xx hibák újrapróbálkozásra kerülnek; az lejárt tokenek egyszer frissítésre kerülnek, és a hívás újrapróbálkozásra kerül.
anpheros_sdk
Dart / Flutter kliens a Anpheros Platform-hoz: egy egészségügyi adat-backend FHIR R4 rekordokkal betegenként, projekt elkülönítéssel, beteg hozzájárulással (OAuth 2.1 / SMART on FHIR), minden íráshoz származási információval és egy AI kontext API-val.
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));
Személy nevében történő cselekvés (alkalmazások)
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!);
Minden objektum tartalmaz fhir (annak /fhir/R4 referenciája); a anpheros.fhir nyers FHIR hozzáférést biztosít
(olvasás, keresés, létrehozás, tranzakció, $everything, $summary, $validate).
A hibákat AnpherosException jelzi status, type, message, field és requestId.
A létrehozások automatikusan küldenek egy Idempotency-Key; a 429/5xx hibákat visszalépéssel próbáljuk újra; az
lejárt OAuth tokeneket egyszer frissítjük, és a hívást megismételjük.
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card