Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Buduj z Anpheros
Droga od dostępu do produkcji w dziewięciu krokach — uwierzytelnianie, API, dane medyczne, zgoda, FHIR, webhooki, SDK i uruchomienie — z przewodnikiem dla każdego kroku.
Budowanie na Anpheros oznacza wykorzystanie go jako warstwy danych medycznych Twojej aplikacji: Twój produkt wywołuje API Anpheros do przechowywania i odczytu danych pacjentów w formacie HL7 FHIR R4, do uzyskiwania zgody pacjenta i do odbierania zdarzeń. Ta strona jest mapą od pierwszego dostępu do produkcji; każdy krok zawiera link do szczegółowego przewodnika.
1. Uzyskaj dostęp
Platforma Anpheros jest w wersji prywatnej beta. Piaskownica jest samoobsługowa: zaloguj się za pomocą Google na pulpicie nawigacyjnym (https://platform.anpheros.com/dashboard/) i naciśnij Uzyskaj klucz piaskownicy — otrzymasz organizację, projekt piaskownicy z własnymi 30 syntetycznymi pacjentami i klucz. Dostęp produkcyjny jest na żądanie ([email protected]). Tworzysz kolejne projekty i klucze API na pulpicie nawigacyjnym lub za pośrednictwem Admin API; aplikacje OAuth są rejestrowane za pomocą POST /admin/projects/{id}/applications, a webhooki za pomocą POST /v1/webhooks.
Projekt jest jednostką izolacji: jego klucze widzą tylko utworzonych przez niego pacjentów (oraz, za zgodą, tych, którzy udzielili mu dostępu).
2. Uwierzytelnianie
| Poświadczenie | Dla | Wygląda jak |
|---|---|---|
| Klucz API | Twoje serwery | sk_test_… (sandbox), sk_live_… (produkcja) |
| Token dostępu OAuth | aplikacja działająca w imieniu jednego pacjenta | at_…, ważny 30 minut, odświeżany za pomocą rotującego tokena odświeżania |
Wyślij go jako Authorization: Bearer <credential>. Klucze są pokazywane raz i nigdy nie powinny znajdować się w aplikacji mobilnej ani webowej. → Uwierzytelnianie i OAuth
3. Połączenie z API
URL bazowy https://platform.anpheros.com; REST pod adresem /v1, FHIR R4 pod adresem /fhir/R4. Interaktywny podręcznik i specyfikacja OpenAPI opisują każdy punkt końcowy.
curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"
→ Dokumentacja API · Healthcare API
4. Tworzenie i odczytywanie danych medycznych
Utwórz pacjenta dla każdego ze swoich użytkowników, zapisz obserwacje, schorzenia, leki i dokumenty za pomocą Idempotency-Key, a następnie odczytaj je jako listy lub oś czasu. Określ autora każdego zapisu (patient, practitioner, device, import, ai).
→ Pierwsze kroki · API danych medycznych · Tworzenie aplikacji medycznej
5. Dodaj zgodę
Aby uzyskać dostęp do rekordu, który osoba już przechowuje w Anpheros, zarejestruj aplikację OAuth z jej URI przekierowania, prześlij osobę na stronę zgody z potrzebnymi zakresami (scopes) i wymień kod (PKCE) na tokeny. Osoba wybiera czas trwania i może w każdej chwili cofnąć dostęp; każde odczytanie jest dla niej widoczne.
→ Model zgody i dostępu · Uwierzytelnianie i OAuth
6. Używaj FHIR, gdy potrzebujesz pełnego modelu
Typy zasobów inne niż te dostępne przez REST API — szczepienia, procedury, plany opieki, alergie, wizyty i inne, łącznie 26 — są dostępne przez FHIR R4, wraz z wyszukiwaniem, historią, transakcjami, $everything i Międzynarodowym Podsumowaniem Pacjenta ($summary).
→ Platforma FHIR · Systemy kodowania FHIR · Interoperacyjność danych w opiece zdrowotnej
7. Reagowanie na zdarzenia
Zarejestruj punkt końcowy webhook dla zdarzeń resource.*, consent.* lub document.finalized i weryfikuj Anpheros-Signature każdej dostawy. Raporty laboratoryjne mogą być wysyłane w jednym wywołaniu do konektora laboratoryjnego.
→ Webhooks · Lab connector · Healthcare integrations
8. Użyj SDK
@anpheros/sdk (TypeScript: Node 18+, przeglądarki, Deno, Bun) i anpheros_sdk (Dart / Flutter) obejmują całe publiczne API o tym samym kształcie, dodają klucze idempotencji do tworzenia, ponawiają próby przy 429/5xx, odświeżają tokeny i implementują przepływ zgody.
npm install @anpheros/sdk # or: dart pub add anpheros_sdk
→ SDK
9. Przejście na produkcję
- Klucze produkcyjne (
sk_live_) są wydawane zweryfikowanym organizacjom z podpisaną umową o przetwarzaniu danych. - Zaplanuj ograniczenia wersji prywatnej wersji beta: pojedyncza strefa, brak umownego SLA, 600 żądań na minutę na klucz i na adres IP.
- Obsługuj błędy według typu i zachowaj
Anpheros-Request-Iddo celów wsparcia. - Przejrzyj, w jaki sposób dane są chronione i gdzie są przechowywane.
→ Bezpieczeństwo, prywatność i lokalizacja danych · Limity · Błędy · Wersjonowanie i wycofywanie
Dodawanie AI
Jeśli Twój produkt zawiera asystenta lub agenta AI, API kontekstu przygotowuje odpowiednią część rekordu dla używanego modelu, w ramach limitu tokenów i z każdym elementem oznaczonym źródłem. → Aplikacje AI w opiece zdrowotnej
Powiązane
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card