Aller au contenu
FibonacciDentisterieConnexionEssai gratuit

Pour les développeurs

Connecte ton programme à Fibonacci

Les API sont ouvertes, en FHIR R4 avec OAuth 2.0. Le cabinet décide ce que ton programme peut lire et peut lui retirer l’accès quand il veut.

L'écran d'un ordinateur portable avec du code coloré.
La marque de Fibonacci pour la médecine esthétique : une chemise blanche avec la spirale d'or sur un carré bleu.
Accès pour programmes externesDes autorisations strictes, décidées par le cabinetFHIR R4, aucune donnée clinique

Authentification

Comment se connecter : deux modes

Clé du cabinet

Qui peut l’utiliser : un cabinet, pour son propre programme ou celui d’un prestataire qui travaille pour lui. Elle est créée par la personne qui administre le cabinet, et la fonction s’active sur demande.

Trois permissions, cumulables : agenda en lecture seule, demandes de rendez-vous et coordonnées des patients.

Le secret ne s’affiche qu’une seule fois et le token dure une heure.

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 enregistrée, avec le consentement du cabinet À venir

Qui peut l’utiliser : une entreprise qui fait un produit pour plusieurs cabinets. Nous l’enregistrons, une par une, et chaque cabinet la connecte en un clic.

Cinq permissions fermées : agenda en lecture et en écriture, demandes de rendez-vous, coordonnées et factures en lecture sans les lignes.

Aucun secret partagé : le JWT se signe avec ta clé privée et dure au maximum cinq minutes.

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"

Aucune donnée clinique ne passe. Anamnèse, consultations, traitements, photos, consentements et factures restent en dehors, quelle que soit la permission choisie par le cabinet : les demander renvoie un 403.

Guide rapide

Cinq étapes pour le premier appel

  1. Tu nous écris ce que fait ton programme

    Depuis la page Partenaire, avec les autorisations dont tu as besoin.

  2. Le cabinet active l’accès

    Celui qui l’administre crée une clé, ou connecte ton app enregistrée.

  3. Demande le token

    Il dure une heure : demande-le une fois et réutilise-le.

  4. Tu appelles les API FHIR R4

    Uniquement sur les adresses du cabinet qui t’a donné l’accès.

  5. Reçois les notifications

    Un message signé quand un rendez-vous est créé, modifié ou annulé.

Exemples

Lire les créneaux libres et recevoir les notifications

Le guide technique complet, avec toutes les réponses et les erreurs, nous l'envoyons à la personne désignée par le cabinet.

Lire les créneaux libres

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

La notification qui arrive à ton programme

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'en-tête X-Fibonacci-Firma porte l'heure et la signature du corps : tu la vérifies avec le secret que le cabinet ne voit qu'une seule fois.

Sans écrire de code : Zapier, Make, n8n et MCP utilisent les mêmes accès, avec les mêmes clés. Les connexions d'aujourd'hui

Questions fréquentes

Les questions de celui qui écrit la connexion

Quels standards utilisez-vous ?

FHIR R4 pour les données et OAuth 2.0 avec client credentials pour l'accès. Les notifications sont des JSON signés.

Puis-je rechercher les patients par nom ?

Non. Les listes de patients et de rendez-vous ne peuvent pas être recherchées : une recherche par nom révélerait de toute façon le nom. Les codes t'arrivent avec les notifications ou depuis les créneaux.

Que se passe-t-il si le cabinet révoque la clé ?

Le token que tu as cesse de fonctionner immédiatement, pas à l'expiration, et on ne peut plus en demander un nouveau.

Y a-t-il des limites de requêtes ?

Oui. Le token dure une heure : demande-le une fois et réutilise-le. Au-delà de la limite, l'adresse du token répond 429.

Faut-il un contrat avec le cabinet ?

En règle générale, oui : un programme qui traite ces données pour le compte du cabinet est un sous-traitant, et l'accord de l'article 28 du GDPR entre toi et le cabinet est nécessaire.

Tu veux connecter ton produit à Fibonacci ?

Écris-nous ce qu'il fait et quelles données il lui faut. La connexion, nous la concevons ensemble.