API do danych medycznych: na co zwrócić uwagę, jak odczytywać i zapisywać dane pacjenta w ciągu godziny

"API opieki zdrowotnej" obejmuje bardzo różne rzeczy: kanał HL7 v2 szpitala, krajowy serwis e-recept, eksport danych od producenta urządzenia noszonego, serwer FHIR. Jeśli tworzysz aplikację zdrowotną, narzędzie dla kliniki lub asystenta AI, potrzebujesz czegoś bardziej ukierunkowanego: backendu, który przechowuje dane pacjenta w standardowym formacie, pozwala pacjentowi decydować, kto ma do nich dostęp, i udostępnia czyste API. Ten przewodnik wyjaśnia, czego szukać i pokazuje, wraz z rzeczywistymi wywołaniami, jak wygląda pierwsza godzina pracy z Anpheros Platform.

Wersja techniczna dla deweloperów: API opieki zdrowotnej · API danych medycznych na developers.anpheros.com, z żądaniami, odpowiedziami i limitami. Ta strona to wersja w prostym języku.

Co powinno robić API danych opieki zdrowotnej

Pięć rzeczy odróżnia użyteczne API danych medycznych od bazy danych z interfejsem HTTP.

• Standardowy format. HL7 FHIR R4 to format używany przez szpitale, systemy krajowe i europejską przestrzeń danych zdrowotnych. Rekord przechowywany w FHIR może być odczytany przez inne systemy bez niestandardowego mostu. Własny format JSON nie może.
• Zgoda pacjenta jako obiekt pierwszej kategorii. Kto może czytać co, jak długo, z możliwością cofnięcia, widoczne dla pacjenta. Nie jest to pole wyboru w Twojej własnej bazie danych.
• Pochodzenie danych (Provenance). Każda wartość mówi, kto ją zapisał: pacjent, lekarz, urządzenie, import, obliczenie pochodne. Asystent AI, który nie potrafi odróżnić wyniku laboratoryjnego od samodzielnie zgłoszonej przypuszczenia, jest niebezpieczny.
• Piaskownica z realistycznymi danymi. Nie możesz testować na prawdziwych pacjentach i nie powinieneś musieć samodzielnie tworzyć 30 syntetycznych pacjentów z sześciomiesięczną historią.
• Możliwość określenia lokalizacji danych. Dla użytkowników europejskich oznacza to serwery w UE, zgodne z RODO, z umową o przetwarzaniu danych.

Dwa sposoby dostępu: REST i FHIR, te same dane

Anpheros Platform udostępnia ten sam rekord dwukrotnie. Proste API REST (/v1) dla kodu produktu i ścisłe FHIR R4 (/fhir/R4) dla wszystkiego, co musi komunikować się z resztą systemu opieki zdrowotnej. Identyfikatory są identyczne w obu przypadkach; każdy obiekt v1 zawiera swoje odniesienie do fhir.

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

# pacjenci widoczni dla Twojego projektu
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

# wyniki badań laboratoryjnych, najnowsze najpierw
curl "$BASE/v1/patients/$PID/observations?category=laboratory&limit=10" -H "Authorization: Bearer $KEY"

# aktywne leki
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"

# wszystko na jednej osi czasu
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"

# te same dane, ścisłe FHIR
curl "$BASE/fhir/R4/Observation?patient=$PID&code=http://loinc.org|4548-4&_sort=-date" -H "Authorization: Bearer $KEY"

Za tymi wywołaniami kryje się 26 typów zasobów FHIR (Patient, Observation, Condition, MedicationStatement, AllergyIntolerance, Immunization, DocumentReference, Encounter, Consent, Provenance i inne), kodowanych za pomocą LOINC dla pomiarów, ICD-10 dla schorzeń i ATC dla leków.

Uzyskanie klucza zajmuje minutę

Piaskownica jest samoobsługowa i bezpłatna. Zaloguj się do panelu na platform.anpheros.com/dashboard, naciśnij Uzyskaj klucz piaskownicy, a otrzymasz organizację, projekt piaskownicy i klucz sk_test_…. Projekt zawiera własną kopię 30 syntetycznych pacjentów: dorosłych, dzieci i starszych ludzi z całej UE, ze schorzeniami, lekami, alergiami, wynikami badań laboratoryjnych i danymi o parametrach życiowych z sześciu miesięcy. Zmieniaj lub usuwaj wszystko; reset przywróci ich do stanu początkowego.

Klucze produkcyjne (sk_live_…) są przeznaczone dla zweryfikowanych organizacji z podpisaną umową o przetwarzaniu danych. Piaskownica i produkcja to różne bazy danych: klucz piaskownicy fizycznie nie może uzyskać dostępu do prawdziwych pacjentów.

Co jeszcze jest w zestawie

• OAuth 2.1 z PKCE i SMART on FHIR standalone launch, dzięki czemu aplikacja może poprosić użytkownika o dostęp do jego własnych danych.
• Zgoda z zakresami (scopes), datą wygaśnięcia i możliwością cofnięcia, a także dziennikiem dostępu, który pacjent może odczytać.
• Podpisane webhooki (HMAC-SHA256, z ponownymi próbami i opóźnieniem) dla zdarzeń resource.created, consent.granted, consent.revoked, document.finalized.
• API kontekstu AI, które buduje podsumowanie pacjenta z etykietami pochodzenia danych w ramach budżetu tokenów.
• Import raportów laboratoryjnych z CSV, HL7 v2 ORU^R01 lub JSON, mapowany do LOINC.
• Międzynarodowy Podsumowanie Pacjenta ($summary) i SMART Health Links do udostępniania przez QR.
• SDK dla Dart i TypeScript, dokumentacja OpenAPI pod adresem /docs i CapabilityStatement pod adresem /fhir/R4/metadata.

Pełny opis krok po kroku, wraz z odpowiedziami, znajduje się na stronie developers.anpheros.com/guides/first-hour.

Najczęstsze pytania

Czy istnieje darmowe API opieki zdrowotnej, z którego mogę zacząć korzystać już dziś?

Tak. Piaskownica Anpheros jest darmowa i samoobsługowa: zaloguj się, uzyskaj klucz, a otrzymasz 30 syntetycznych pacjentów do odczytu i zapisu. Limity wynoszą 10 000 zapisów zasobów dziennie, 100 własnych pacjentów i 250 MB dokumentów na projekt.

REST czy FHIR, którego powinienem użyć?

Użyj /v1 dla własnego kodu produktu: jest prostszy i zwraca czysty JSON. Użyj /fhir/R4, gdy dane muszą być odczytane przez inny system, gdy potrzebujesz wyszukiwania FHIR, _history, $everything lub $summary, lub gdy wymaga tego certyfikacja. Oba widzą ten sam rekord.

Jak obsługiwana jest zgoda pacjenta?

Osoba udziela aplikacji dostępu do swoich danych poprzez OAuth, wybierając zakresy (scopes) i czas trwania (30, 90, 180 lub 365 dni). Zgoda może być cofnięta w dowolnym momencie, a pacjent widzi każdy odczyt w dzienniku dostępu. Szczegóły w modelu zgody.

Gdzie są przechowywane dane?

W Unii Europejskiej (Cloud Run, europe-west4), z pochodzeniem danych i historią wersji przy każdym zapisie. Użycie produkcyjne wymaga podpisanej umowy o przetwarzaniu danych.

Ile kosztuje produkcja?

Produkcja zaczyna się od 49 € miesięcznie za 2 500 przechowywanych pacjentów, z pierwszym miesiącem gratis; większe plany kosztują 199 € i 799 € miesięcznie. Piaskownica pozostaje darmowa. Zobacz cennik.

Czy działa z agentami AI?

Tak. Istnieje API kontekstu AI z etykietami pochodzenia danych i budżetem tokenów, a także serwer MCP pod adresem platform.anpheros.com/mcp, do którego może połączyć się każdy asystent zgodny z MCP. Zobacz Integracja EMR z asystentami medycznymi AI.