# Budowanie z Anpheros

> Ścieżka od dostępu do produkcji w dziewięciu krokach — uwierzytelnianie, API, dane medyczne, zgoda, FHIR, webhooks, SDK i uruchomienie — z przewodnikiem dla każdego kroku.

Source: https://developers.anpheros.com/pl/guides/build-with-anpheros

**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 (`contact@anpheros.com`). 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](https://developers.anpheros.com/pl/guides/authentication)

## 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.

```bash
curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY"
```

→ [Dokumentacja API](https://developers.anpheros.com/docs) · [Healthcare API](https://developers.anpheros.com/pl/guides/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](https://developers.anpheros.com/pl/guides/getting-started) · [API danych medycznych](https://developers.anpheros.com/pl/guides/medical-data-api) · [Tworzenie aplikacji medycznej](https://developers.anpheros.com/pl/guides/build-a-healthcare-app)

## 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](https://developers.anpheros.com/pl/guides/consent) · [Uwierzytelnianie i OAuth](https://developers.anpheros.com/pl/guides/authentication)

## 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](https://developers.anpheros.com/pl/guides/fhir) · [Systemy kodowania FHIR](https://developers.anpheros.com/pl/guides/fhir-code-systems) · [Interoperacyjność danych w opiece zdrowotnej](https://developers.anpheros.com/pl/guides/interoperability)

## 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](https://developers.anpheros.com/pl/guides/webhooks) · [Lab connector](https://developers.anpheros.com/pl/guides/lab-connector) · [Healthcare integrations](https://developers.anpheros.com/pl/guides/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.

```bash
npm install @anpheros/sdk        # or: dart pub add anpheros_sdk
```

→ [SDK](https://developers.anpheros.com/pl/guides/sdks)

## 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-Id` do celów wsparcia.
- Przejrzyj, w jaki sposób dane są chronione i gdzie są przechowywane.

→ [Bezpieczeństwo, prywatność i lokalizacja danych](https://developers.anpheros.com/pl/guides/security) · [Limity](https://developers.anpheros.com/pl/guides/limits) · [Błędy](https://developers.anpheros.com/pl/guides/errors) · [Wersjonowanie i wycofywanie](https://developers.anpheros.com/pl/guides/versioning)

## 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](https://developers.anpheros.com/pl/guides/ai-healthcare)

## Powiązane

- [Anpheros dla deweloperów](https://developers.anpheros.com/pl/guides/developers)
- [Tworzenie oprogramowania dla branży medycznej](https://developers.anpheros.com/pl/guides/healthcare-software)
- [Startupy medyczne](https://developers.anpheros.com/pl/guides/healthcare-startups)