# Costruisci con Anpheros > Il percorso dall'accesso alla produzione in nove passaggi — autenticazione, API, dati medici, consenso, FHIR, webhook, SDK e messa in produzione — con la guida per ogni passaggio. Source: https://developers.anpheros.com/it/guides/build-with-anpheros **Costruire su Anpheros significa usarlo come livello di dati medici della tua applicazione: il tuo prodotto chiama l'API Anpheros per archiviare e leggere le cartelle cliniche in HL7 FHIR R4, per ottenere il consenso del paziente e per ricevere eventi.** Questa pagina è la mappa dal primo accesso alla produzione; ogni passaggio rimanda alla guida che lo tratta in dettaglio. ## 1. Ottenere l'accesso La Piattaforma Anpheros è in beta privata. Il sandbox è self-service: accedi con Google sulla dashboard (`https://platform.anpheros.com/dashboard/`) e premi *Ottieni una chiave sandbox* — otterrai un'organizzazione, un progetto sandbox con i propri 30 pazienti sintetici e una chiave. L'accesso in produzione è su richiesta (`contact@anpheros.com`). Creerai ulteriori progetti e chiavi API nella dashboard o tramite l'Admin API; le applicazioni OAuth vengono registrate con `POST /admin/projects/{id}/applications` e i webhook con `POST /v1/webhooks`. Un **progetto** è l'unità di isolamento: le sue chiavi vedono solo i pazienti che ha creato (e, con consenso, quelli che gli hanno concesso l'accesso). ## 2. Autenticazione | Credenziale | Per | Aspetto | |---|---|---| | Chiave API | i tuoi server | `sk_test_…` (sandbox), `sk_live_…` (produzione) | | Token di accesso OAuth | un'app che agisce per un paziente | `at_…`, valido 30 minuti, aggiornato con un token di aggiornamento rotante | Inviala come `Authorization: Bearer `. Le chiavi vengono mostrate una sola volta e non devono mai trovarsi in un'app mobile o web. → [Autenticazione e OAuth](https://developers.anpheros.com/it/guides/authentication) ## 3. Connettersi all'API URL di base `https://platform.anpheros.com`; REST a `/v1`, FHIR R4 a `/fhir/R4`. Il riferimento interattivo e la specifica OpenAPI descrivono ogni endpoint. ```bash curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $KEY" ``` → [Riferimento API](https://developers.anpheros.com/docs) · [API Sanitaria](https://developers.anpheros.com/it/guides/healthcare-api) ## 4. Creare e leggere dati medici Crea un paziente per ciascuno dei tuoi utenti, scrivi osservazioni, condizioni, farmaci e documenti con un `Idempotency-Key` e rileggili come liste o una timeline. Indica l'autore di ogni scrittura (`patient`, `practitioner`, `device`, `import`, `ai`). → [Iniziare](https://developers.anpheros.com/it/guides/getting-started) · [API dati medici](https://developers.anpheros.com/it/guides/medical-data-api) · [Creare un'app sanitaria](https://developers.anpheros.com/it/guides/build-a-healthcare-app) ## 5. Aggiungere il consenso Per raggiungere un record che una persona ha già in Anpheros, registra un'applicazione OAuth con il suo redirect URI, invia la persona alla pagina di consenso con gli scope necessari e scambia il codice (PKCE) per i token. La persona sceglie la durata e può revocare l'accesso in qualsiasi momento; ogni lettura è visibile. → [Modello di consenso e accesso](https://developers.anpheros.com/it/guides/consent) · [Autenticazione e OAuth](https://developers.anpheros.com/it/guides/authentication) ## 6. Utilizzare FHIR quando è necessario il modello completo I tipi di risorse oltre l'API REST — immunizzazioni, procedure, piani di assistenza, allergie, incontri e altri, 26 in totale — sono disponibili tramite FHIR R4, insieme a ricerca, cronologia, transazioni, `$everything` e l'International Patient Summary (`$summary`). → [Piattaforma FHIR](https://developers.anpheros.com/it/guides/fhir) · [Sistemi di codici FHIR](https://developers.anpheros.com/it/guides/fhir-code-systems) · [Interoperabilità dei dati sanitari](https://developers.anpheros.com/it/guides/interoperability) ## 7. Reagire agli eventi Registra un endpoint webhook per gli eventi `resource.*`, `consent.*` o `document.finalized` e verifica la `Anpheros-Signature` di ogni consegna. I referti di laboratorio possono essere inviati in un'unica chiamata al connettore di laboratorio. → [Webhooks](https://developers.anpheros.com/it/guides/webhooks) · [Lab connector](https://developers.anpheros.com/it/guides/lab-connector) · [Healthcare integrations](https://developers.anpheros.com/it/guides/healthcare-integrations) ## 8. Utilizzare un SDK `@anpheros/sdk` (TypeScript: Node 18+, browser, Deno, Bun) e `anpheros_sdk` (Dart / Flutter) coprono l'intera API pubblica con la stessa struttura, aggiungono chiavi di idempotenza alle creazioni, ritentano in caso di `429`/`5xx`, aggiornano i token e implementano il flusso di consenso. ```bash npm install @anpheros/sdk # or: dart pub add anpheros_sdk ``` → [SDK](https://developers.anpheros.com/it/guides/sdks) ## 9. Passare alla produzione - Le chiavi di produzione (`sk_live_`) vengono rilasciate a organizzazioni verificate con un accordo di elaborazione dati firmato. - Pianificare i limiti della beta privata: singola zona, nessun SLA contrattuale, 600 richieste al minuto per chiave e per IP. - Gestire gli errori per tipo e conservare `Anpheros-Request-Id` per il supporto. - Rivedere come vengono protetti i dati e dove vengono archiviati. → [Sicurezza, privacy e residenza dei dati](https://developers.anpheros.com/it/guides/security) · [Limiti](https://developers.anpheros.com/it/guides/limits) · [Errori](https://developers.anpheros.com/it/guides/errors) · [Versioning e deprecazione](https://developers.anpheros.com/it/guides/versioning) ## Aggiungere l'IA Se il tuo prodotto include un assistente o un agente IA, l'API di contesto prepara la parte pertinente di un record per il modello che utilizzi, entro un budget di token e con ogni elemento etichettato per origine. → [Applicazioni sanitarie IA](https://developers.anpheros.com/it/guides/ai-healthcare) ## Correlati - [Anpheros per sviluppatori](https://developers.anpheros.com/it/guides/developers) - [Sviluppo di software sanitario](https://developers.anpheros.com/it/guides/healthcare-software) - [Startup sanitarie](https://developers.anpheros.com/it/guides/healthcare-startups)