# Építs az Anpheros segítségével

> A hozzáféréstől a produkciós környezetig vezető út kilenc lépésben — hitelesítés, API, orvosi adatok, hozzájárulás, FHIR, webhookok, SDK-k és az élesítés — útmutatóval minden lépéshez.

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

**Az Anpherosra építeni azt jelenti, hogy azt használod az alkalmazásod orvosiadat-rétegeként: a terméked az Anpheros API-t hívja a páciensrekordok HL7 FHIR R4 formátumban történő tárolására és olvasására, a páciens hozzájárulásának megszerzésére és események fogadására.** Ez az oldal a térkép az első hozzáféréstől a produkciós környezetig; minden lépés a részletesen tárgyaló útmutatóra hivatkozik.

## 1. Hozzáférés igénylése

Az Anpheros Platform privát béta verzióban érhető el. A sandbox önkiszolgáló: jelentkezzen be a Google-lel a dashboardon (`https://platform.anpheros.com/dashboard/`), és nyomja meg a *Get a sandbox key* gombot – így kap egy szervezetet, egy sandbox projektet 30 szintetikus beteggel, valamint egy kulcsot. A production hozzáférés kérésre történik (`contact@anpheros.com`). További projekteket és API kulcsokat a dashboardon vagy az Admin API-n keresztül hozhat létre; az OAuth alkalmazások a `POST /admin/projects/{id}/applications`-nél, a webhookok pedig a `POST /v1/webhooks`-nél regisztrálhatók.

A **projekt** az izoláció egysége: a projekt kulcsai csak az általa létrehozott betegeket látják (és beleegyezéssel azokat, akik hozzáférést biztosítottak neki).

## 2. Hitelesítés

| Hitelesítő adat | Mire | Hasonló |
|---|---|---|
| API kulcs | a szervereidhez | `sk_test_…` (sandbox), `sk_live_…` (production) |
| OAuth hozzáférési token | egy alkalmazás, amely egy páciens nevében jár el | `at_…`, 30 percig érvényes, forgó frissítő tokennel frissítve |

Küldd el `Authorization: Bearer <credential>`-ként. A kulcsokat csak egyszer mutatjuk meg, és soha nem szabad mobil vagy webes alkalmazásban tárolni. → [Hitelesítés és OAuth](https://developers.anpheros.com/hu/guides/authentication)

## 3. Csatlakozás az API-hoz

Alap URL `https://platform.anpheros.com`; REST itt: `/v1`, FHIR R4 itt: `/fhir/R4`. Az interaktív referenciák és az OpenAPI specifikáció minden végpontot leírnak.

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

→ [API referenciák](https://developers.anpheros.com/docs) · [Egészségügyi API](https://developers.anpheros.com/hu/guides/healthcare-api)

## 4. Orvosi adatok létrehozása és olvasása

Hozzon létre egy pácienst minden felhasználója számára, írjon megfigyeléseket, állapotokat, gyógyszereket és dokumentumokat egy `Idempotency-Key` segítségével, majd olvassa vissza őket listákban vagy idővonalon. Adja meg minden írás szerzőjét (`patient`, `practitioner`, `device`, `import`, `ai`).

→ [Elkezdeni](https://developers.anpheros.com/hu/guides/getting-started) · [Orvosi adatok API](https://developers.anpheros.com/hu/guides/medical-data-api) · [Egészségügyi alkalmazás készítése](https://developers.anpheros.com/hu/guides/build-a-healthcare-app)

## 5. Hozzájárulás hozzáadása

Egy személy Anpherosban tárolt rekordjának eléréséhez regisztráljon egy OAuth alkalmazást a visszairányítási URI-jával, küldje el a személyt a hozzájárulási oldalra a szükséges scope-okkal, és cserélje be a kódot (PKCE) tokenekre. A személy kiválaszthatja a tartósságot, és bármikor visszavonhatja a hozzáférést; minden olvasás látható számára.

→ [Hozzájárulás és hozzáférési modell](https://developers.anpheros.com/hu/guides/consent) · [Hitelesítés és OAuth](https://developers.anpheros.com/hu/guides/authentication)

## 6. Használja a FHIR-t, ha a teljes modellre van szüksége

A REST API-n túlmutató erőforrástípusok – oltások, eljárások, gondozási tervek, allergiák, találkozók és mások, összesen 26 – elérhetők a FHIR R4-en keresztül, a keresés, az előzmények, a tranzakciók, a `$everything` és a Nemzetközi Betegösszefoglaló (`$summary`) mellett.

→ [FHIR platform](https://developers.anpheros.com/hu/guides/fhir) · [FHIR kódrendszerek](https://developers.anpheros.com/hu/guides/fhir-code-systems) · [Egészségügyi adatinteroperabilitás](https://developers.anpheros.com/hu/guides/interoperability)

## 7. Eseményekre való reagálás

Regisztráljon egy webhook végpontot a `resource.*`, `consent.*` vagy `document.finalized` eseményekhez, és ellenőrizze minden kézbesítés `Anpheros-Signature`-ét. Laboratóriumi jelentések egy hívással elküldhetők a labor csatlakozóhoz.

→ [Webhooks](https://developers.anpheros.com/hu/guides/webhooks) · [Lab connector](https://developers.anpheros.com/hu/guides/lab-connector) · [Healthcare integrations](https://developers.anpheros.com/hu/guides/healthcare-integrations)

## 8. SDK használata

A `@anpheros/sdk` (TypeScript: Node 18+, böngészők, Deno, Bun) és a `anpheros_sdk` (Dart / Flutter) ugyanazzal a struktúrával lefedi a teljes nyilvános API-t, hozzáadja az idempotencia kulcsokat a létrehozásokhoz, újrapróbálkozik `429`/`5xx` esetén, frissíti a tokeneket és implementálja a hozzájárulási folyamatot.

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

→ [SDK-k](https://developers.anpheros.com/hu/guides/sdks)

## 9. Éles környezetbe lépés

- Az éles kulcsokat (`sk_live_`) hitelesített szervezetek kapják meg, aláírt adatfeldolgozási megállapodással.
- Tervezze meg a privát béta korlátait: egyetlen zóna, nincs szerződéses SLA, 600 kérés percenként kulcsonként és IP címenként.
- Kezelje a hibákat típus szerint, és tartsa meg a `Anpheros-Request-Id` azonosítót a támogatáshoz.
- Tekintse át, hogyan védett az adat, és hol tárolják azt.

→ [Biztonság, adatvédelem és adattárolás helye](https://developers.anpheros.com/hu/guides/security) · [Korlátok](https://developers.anpheros.com/hu/guides/limits) · [Hibák](https://developers.anpheros.com/hu/guides/errors) · [Verziókezelés és elavulás](https://developers.anpheros.com/hu/guides/versioning)

## AI hozzáadása

Ha a terméke tartalmaz egy AI asszisztenst vagy ügynököt, a kontextus API előkészíti a rekord releváns részét az Ön által használt modell számára, egy token kereten belül, és minden elemet forrás szerint címkézve. → [AI egészségügyi alkalmazások](https://developers.anpheros.com/hu/guides/ai-healthcare)

## Kapcsolódó

- [Anpheros fejlesztőknek](https://developers.anpheros.com/hu/guides/developers)
- [Egészségügyi szoftverfejlesztés](https://developers.anpheros.com/hu/guides/healthcare-software)
- [Egészségügyi startupok](https://developers.anpheros.com/hu/guides/healthcare-startups)