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

Stwórz aplikację medyczną

Samouczek: użyj Anpheros jako backendu danych medycznych aplikacji medycznej — pacjenci, pomiary, schorzenia, leki, dokumenty, badania, zgoda, webhooki i SDK.

Ten samouczek pokazuje, jak aplikacja medyczna lub związana z ochroną zdrowia może wykorzystać Anpheros Platform jako zaplecze danych medycznych: gdzie przechowywane są dane pacjentów, jak są one odczytywane i zapisywane, jak łączone są inne systemy i jak pacjent zachowuje kontrolę. Każde poniższe wywołanie jest częścią publicznego API (referencja).

Co budujesz

Typowa aplikacja dla pacjenta — monitorująca choroby przewlekłe, aplikacja zdrowia rodzinnego, towarzysz zdalnego monitorowania — musi:

prowadzić rejestr dla każdego pacjenta: pomiary, schorzenia, leki, dokumenty;
wyświetlać ten rejestr w postaci list i osi czasu;
akceptować dane z innych źródeł (urządzenia, laboratoria, kliniki);
udostępniać części rejestru za zgodą pacjenta;
reagować na zmiany.

Dzięki Anpheros Twoja aplikacja zarządza własnymi użytkownikami, ekranami i logiką biznesową, a rejestr medyczny deleguje do platformy:

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

Twój backend przechowuje klucz API; aplikacja komunikuje się z Twoim backendem. (Aplikacje działające w imieniu pacjenta, który ma już rejestr Anpheros, zamiast tego używają OAuth — patrz krok 7.)

1. Uzyskaj klucz sandbox

Sandbox jest samoobsługowy: zaloguj się przez Google na pulpicie nawigacyjnym (https://platform.anpheros.com/dashboard/) i naciśnij Uzyskaj klucz sandbox. Klucze sandbox zaczynają się od sk_test_ i mogą uzyskiwać dostęp tylko do bazy danych sandbox, gdzie Twój projekt ma już własną kopię 30 syntetycznych pacjentów.

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

2. Utwórz pacjenta

Każdy użytkownik Twojej aplikacji otrzymuje rekord pacjenta należący do Twojego projektu.

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"}'

Odpowiedź zawiera identyfikator pacjenta id (Twój własny identyfikator tej osoby — inne projekty widzą inny) oraz jego referencję fhir.

3. Zapisywanie pomiarów, schorzeń i leków

Określ, skąd pochodzą dane, używając author_type: patient, practitioner, device, import lub ai. Jeśli tego nie zrobisz, platforma zapisze import, nigdy patient przez domniemanie.

# 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"}'

Kategorie obserwacji: vital-signs, laboratory, symptom, activity, survey, exam, imaging, social-history. Każdy zapis jest przechowywany jako zasób FHIR i automatycznie otrzymuje wpis Provenance.

4. Przechowywanie dokumentów

# 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

Oryginał jest niezmienny po przesłaniu; wartości, które z niego wyodrębnisz, mogą do niego wskazywać za pomocą derived_from.

5. Odczytanie rekordu

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

Gdy potrzebny jest pełny model FHIR, te same dane są dostępne pod adresem /fhir/R4 z tymi samymi identyfikatorami (FHIR R4 API).

6. Połącz laboratoria i urządzenia

Wyniki laboratoryjne: POST /v1/patients/{id}/labs/import w formacie CSV, HL7 v2 ORU^R01 lub JSON przekształcają cały raport w obserwacje laboratoryjne z kodami LOINC (Łącznik laboratoriów).
Urządzenia i urządzenia noszone: zapisują obserwacje z author_type: device i kodem LOINC pomiaru (tętno, SpO₂, kroki, czas trwania snu i inne są wymienione w Systemach kodów FHIR).

7. Uzyskanie dostępu do istniejącego rekordu pacjenta (OAuth)

Jeśli osoba posiada już rekord w Anpheros (na przykład za pośrednictwem Anpheros Daily), Twoja aplikacja może poprosić o dostęp zamiast tworzyć nowego pacjenta: zarejestruj aplikację, prześlij osobę na stronę zgody z wymaganymi zakresami (scopes), wymień kod na tokeny i wywołaj API za pomocą tokenu dostępu. Pacjent wybiera czas trwania dostępu i może go w dowolnym momencie cofnąć. Szczegóły: Uwierzytelnianie i OAuth.

8. Reaguj na zmiany za pomocą webhooków

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"]}'

Zweryfikuj nagłówek Anpheros-Signature każdego dostarczenia (Webhooks).

9. Użyj SDK

Ten sam przepływ w 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 });

Dostępny jest klient Dart / Flutter o tym samym kształcie jako anpheros_sdk (SDK).

Przed wdrożeniem produkcyjnym

Klucze produkcyjne (sk_live_) są wydawane zweryfikowanym organizacjom z podpisaną umową o przetwarzaniu danych.
Zapoznaj się ze stroną Bezpieczeństwo, prywatność i rezydencja danych oraz limitami.
Obsługuj błędy według ich typu i cytuj nagłówek Anpheros-Request-Id podczas kontaktu z pomocą techniczną (Błędy).

Powiązane

Jak zbudować API medyczne w TypeScript: samouczek krok po kroku z Express
Jak zbudować aplikację medyczną we Flutter: samouczek krok po kroku z Dart SDK
Jak zbudować aplikację AI dla służby zdrowia z backendem FHIR: samouczek krok po kroku w TypeScript
Twórz z Anpheros
Backend i baza danych aplikacji medycznych
API danych medycznych
Tworzenie oprogramowania dla służby zdrowia
Jak zbudować aplikację Personal Health Record (PHR) z FHIR

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