Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Crea con Anpheros

Il percorso dall'accesso alla produzione in nove passi — autenticazione, API, dati medici, consenso, FHIR, webhook, SDK e messa online — con la guida per ogni passo.

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 ([email protected]). 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 <credential>. Le chiavi vengono mostrate una sola volta e non devono mai trovarsi in un'app mobile o web. → Autenticazione e OAuth

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.

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

→ Riferimento API · API Sanitaria

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 · API dati medici · Creare un'app sanitaria

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 · Autenticazione e OAuth

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 · Sistemi di codici FHIR · Interoperabilità dei dati sanitari

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 · Lab connector · 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.

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

→ SDK

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 · Limiti · Errori · Versioning e deprecazione

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

Correlati

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card