Salta al contenuto
FibonacciEsteticaAccediProva gratis

Per gli sviluppatori

Collega il tuo programma a Fibonacci

Le API sono aperte, in FHIR R4 con OAuth 2.0. Lo studio decide che cosa il tuo programma può leggere e può togliergli l’accesso quando vuole.

Lo schermo di un portatile con del codice colorato.
Il marchio di Fibonacci per la medicina estetica: una cartella bianca con la spirale aurea su un quadrato blu.
Accessi per programmi esterniPermessi stretti, decisi dallo studioFHIR R4, nessun dato clinico

Autenticazione

Come si entra: due modi

Chiave dello studio

Chi può usarla: uno studio, per un programma suo o di un fornitore che lavora per lui. La crea chi amministra lo studio, e la funzione si accende su richiesta.

Tre permessi, che si sommano: agenda in sola lettura, richieste di appuntamento e recapiti dei pazienti.

Il segreto si vede una sola volta e il token dura un’ora.

curl -s -X POST "https://app.fibonaccimedica.it/api/oauth2/token" \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode "client_id=$CLIENT_ID" \
  --data-urlencode "client_secret=$CLIENT_SECRET"

App registrata, con il consenso dello studio In arrivo

Chi può usarla: un’azienda che fa un prodotto per molti studi. La registriamo noi, una per una, e ogni studio la collega con un clic.

Cinque permessi chiusi: agenda in lettura e in scrittura, richieste di appuntamento, recapiti e fatture in lettura senza le righe.

Nessun segreto condiviso: il JWT si firma con la tua chiave privata e dura al massimo cinque minuti.

curl -X POST "$TOKEN_URL" \
  -d grant_type=client_credentials \
  -d client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer \
  -d client_assertion="$JWT"

Dati clinici non ne passano. Anamnesi, visite, trattamenti, foto, consensi e fatture restano fuori, qualunque permesso scelga lo studio: chiederli dà 403.

Guida rapida

Cinque passi per la prima chiamata

  1. Ci scrivi che cosa fa il tuo programma

    Dalla pagina Partner, con i permessi che ti servono.

  2. Lo studio attiva l’accesso

    Chi lo amministra crea una chiave, oppure collega la tua app registrata.

  3. Chiedi il token

    Dura un’ora: chiedilo una volta e riusalo.

  4. Chiami le API FHIR R4

    Solo sugli indirizzi dello studio che ti ha dato l’accesso.

  5. Ricevi le notifiche

    Un messaggio firmato quando un appuntamento nasce, cambia o viene annullato.

Esempi

Leggere gli orari liberi e ricevere le notifiche

La guida tecnica completa, con tutte le risposte e gli errori, la mandiamo a chi lo studio ha incaricato.

Leggere gli orari liberi

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://app.fibonaccimedica.it/api/fhir/R4/Slot?schedule=Schedule/$AGENDA&status=free&_sort=start"

La notifica che arriva al tuo programma

POST /notifiche HTTP/1.1
Content-Type: application/json; charset=utf-8
X-Fibonacci-Firma: t=1781342400,v1=9f2c…

{
  "evento": "appuntamento.creato",
  "appuntamento": { "stato": "booked", "inizio": "2026-11-20T09:00:00Z" },
  "riferimenti": { "paziente": "Patient/…", "operatore": "Practitioner/…" }
}

L’intestazione X-Fibonacci-Firma porta l’ora e la firma del corpo: la verifichi con il segreto che lo studio vede una volta sola.

Senza scrivere codice: Zapier, Make, n8n e MCP usano gli stessi accessi, con le stesse chiavi. I collegamenti di oggi

Domande frequenti

Le domande di chi scrive il collegamento

Che standard usate?

FHIR R4 per i dati e OAuth 2.0 con client credentials per l’accesso. Le notifiche sono JSON firmati.

Posso cercare i pazienti per cognome?

No. Gli elenchi di pazienti e appuntamenti non si possono cercare: una ricerca per cognome rivelerebbe comunque il cognome. I codici ti arrivano con le notifiche o dagli orari.

Che cosa succede se lo studio revoca la chiave?

Il token che hai smette di funzionare subito, non alla scadenza, e uno nuovo non si può più chiedere.

Ci sono limiti di richieste?

Sì. Il token dura un’ora: chiedilo una volta e riusalo. Oltre il limite l’indirizzo del token risponde 429.

Serve un contratto con lo studio?

Di norma sì: un programma che tratta questi dati per conto dello studio è un responsabile del trattamento, e serve l’accordo dell’articolo 28 del GDPR fra te e lo studio.

Vuoi collegare il tuo prodotto a Fibonacci?

Scrivici che cosa fa e quali dati gli servono. Il collegamento lo progettiamo insieme.