# Construiți cu Anpheros

> Calea de la acces la producție în nouă pași — autentificare, API, date medicale, consimțământ, FHIR, webhooks, SDK-uri și lansare — cu ghidul pentru fiecare pas.

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

**Construirea pe Anpheros înseamnă utilizarea sa ca strat de date medicale al aplicației dvs.: produsul dvs. apelează API-ul Anpheros pentru a stoca și citi înregistrări ale pacienților în HL7 FHIR R4, pentru a obține consimțământul pacientului și pentru a primi evenimente.** Această pagină este harta de la primul acces la producție; fiecare pas face legătura cu ghidul care îl acoperă în detaliu.

## 1. Obține acces

Platforma Anpheros este în beta privată. Sandbox-ul este self-service: autentifică-te cu Google pe dashboard (`https://platform.anpheros.com/dashboard/`) și apasă pe *Get a sandbox key* — vei primi o organizație, un proiect sandbox cu proprii 30 de pacienți sintetici și o cheie. Accesul de producție se face la cerere (`contact@anpheros.com`). Creezi proiecte suplimentare și chei API în dashboard sau prin Admin API; aplicațiile OAuth sunt înregistrate cu `POST /admin/projects/{id}/applications` și webhooks cu `POST /v1/webhooks`.

Un **proiect** este unitatea de izolare: cheile sale văd doar pacienții pe care i-a creat (și, cu consimțământ, pe cei care i-au acordat acces).

## 2. Autentificare

| Credențial | Pentru | Arată ca |
|---|---|---|
| Cheie API | serverele tale | `sk_test_…` (sandbox), `sk_live_…` (producție) |
| Token de acces OAuth | o aplicație care acționează în numele unui pacient | `at_…`, valabil 30 de minute, reîmprospătat cu un token de reîmprospătare rotativ |

Trimite-l ca `Authorization: Bearer <credential>`. Cheile sunt afișate o singură dată și nu aparțin niciodată unei aplicații mobile sau web. → [Autentificare și OAuth](https://developers.anpheros.com/ro/guides/authentication)

## 3. Conectare la API

URL de bază `https://platform.anpheros.com`; REST la `/v1`, FHIR R4 la `/fhir/R4`. Referința interactivă și specificația OpenAPI descriu fiecare endpoint.

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

→ [Referință API](https://developers.anpheros.com/docs) · [API pentru Sănătate](https://developers.anpheros.com/ro/guides/healthcare-api)

## 4. Crearea și citirea datelor medicale

Creați un pacient pentru fiecare dintre utilizatorii dvs., scrieți observații, afecțiuni, medicamente și documente cu un `Idempotency-Key` și citiți-le înapoi ca liste sau cronologie. Specificați autorul fiecărei scrieri (`patient`, `practitioner`, `device`, `import`, `ai`).

→ [Introducere](https://developers.anpheros.com/ro/guides/getting-started) · [API pentru date medicale](https://developers.anpheros.com/ro/guides/medical-data-api) · [Construiți o aplicație de sănătate](https://developers.anpheros.com/ro/guides/build-a-healthcare-app)

## 5. Adăugați consimțământul

Pentru a accesa o înregistrare pe care o persoană o deține deja în Anpheros, înregistrați o aplicație OAuth cu URI-ul său de redirecționare, trimiteți persoana la pagina de consimțământ cu scopurile de care aveți nevoie și schimbați codul (PKCE) pentru token-uri. Persoana alege durata și poate revoca accesul în orice moment; fiecare citire este vizibilă pentru ea.

→ [Model de consimțământ și acces](https://developers.anpheros.com/ro/guides/consent) · [Autentificare și OAuth](https://developers.anpheros.com/ro/guides/authentication)

## 6. Utilizați FHIR acolo unde aveți nevoie de modelul complet

Tipurile de resurse dincolo de REST API — imunizări, proceduri, planuri de îngrijire, alergii, consultații și altele, 26 în total — sunt disponibile prin FHIR R4, împreună cu căutare, istoric, tranzacții, `$everything` și International Patient Summary (`$summary`).

→ [Platforma FHIR](https://developers.anpheros.com/ro/guides/fhir) · [Sisteme de coduri FHIR](https://developers.anpheros.com/ro/guides/fhir-code-systems) · [Interoperabilitatea datelor din domeniul sănătății](https://developers.anpheros.com/ro/guides/interoperability)

## 7. Reacționați la evenimente

Înregistrați un punct final webhook pentru evenimentele `resource.*`, `consent.*` sau `document.finalized` și verificați `Anpheros-Signature` a fiecărei livrări. Rapoartele de laborator pot fi trimise într-un singur apel către conectorul de laborator.

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

## 8. Utilizați un SDK

`@anpheros/sdk` (TypeScript: Node 18+, browsere, Deno, Bun) și `anpheros_sdk` (Dart / Flutter) acoperă întregul API public cu aceeași structură, adaugă chei de idempotency la creări, reîncearcă la `429`/`5xx`, reîmprospătează token-uri și implementează fluxul de consimțământ.

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

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

## 9. Trecerea în producție

- Cheile de producție (`sk_live_`) sunt emise organizațiilor verificate cu un acord de procesare a datelor semnat.
- Planificați pentru limitele versiunii private beta: zonă unică, fără SLA contractual, 600 de solicitări pe minut per cheie și per IP.
- Gestionați erorile pe tip și păstrați `Anpheros-Request-Id` pentru suport.
- Revizuiți modul în care sunt protejate datele și unde sunt stocate.

→ [Securitate, confidențialitate și rezidența datelor](https://developers.anpheros.com/ro/guides/security) · [Limite](https://developers.anpheros.com/ro/guides/limits) · [Erori](https://developers.anpheros.com/ro/guides/errors) · [Versionare și retragere](https://developers.anpheros.com/ro/guides/versioning)

## Adăugarea AI

Dacă produsul dumneavoastră include un asistent sau agent AI, API-ul de context pregătește partea relevantă a unei înregistrări pentru modelul pe care îl utilizați, în limita unui buget de tokeni și cu fiecare element etichetat după sursă. → [Aplicații AI în domeniul sănătății](https://developers.anpheros.com/ro/guides/ai-healthcare)

## Conexe

- [Anpheros pentru dezvoltatori](https://developers.anpheros.com/ro/guides/developers)
- [Dezvoltare de software în domeniul sănătății](https://developers.anpheros.com/ro/guides/healthcare-software)
- [Startup-uri în domeniul sănătății](https://developers.anpheros.com/ro/guides/healthcare-startups)