Zum Inhalt springen
FibonacciZahnmedizinAnmeldenKostenlos testen

Für Entwickler

Verbinde dein Programm mit Fibonacci

Die APIs sind offen, in FHIR R4 mit OAuth 2.0. Die Praxis entscheidet, was dein Programm lesen darf, und kann ihm den Zugriff jederzeit entziehen.

Der Bildschirm eines Laptops mit farbigem Code.
Das Markenzeichen von Fibonacci für die ästhetische Medizin: eine weiße Mappe mit der goldenen Spirale auf einem blauen Quadrat.
Zugänge für externe ProgrammeEnge Berechtigungen, von der Praxis festgelegtFHIR R4, keine klinischen Daten

Authentifizierung

Wie du reinkommst: zwei Wege

Praxisschlüssel

Wer sie nutzen kann: eine Praxis, für ein eigenes Programm oder das eines Anbieters, der für sie arbeitet. Erstellt wird sie von der Person, die die Praxis verwaltet, und die Funktion wird auf Anfrage freigeschaltet.

Drei Berechtigungen, die sich addieren: Kalender nur lesen, Terminanfragen und Patientenkontaktdaten.

Das Secret wird nur einmal angezeigt, und das Token ist eine Stunde gültig.

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"

Registrierte App, mit Zustimmung der Praxis In Kürze

Wer sie nutzen kann: ein Unternehmen, das ein Produkt für viele Praxen herstellt. Wir registrieren sie einzeln, und jede Praxis verbindet sie mit einem Klick.

Fünf feste Berechtigungen: Kalender lesen und schreiben, Terminanfragen, Kontaktdaten und Rechnungen lesen ohne Positionen.

Kein gemeinsames Secret: Das JWT wird mit deinem privaten Schlüssel signiert und ist höchstens fünf Minuten gültig.

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"

Klinische Daten kommen nicht durch. Anamnese, Untersuchungen, Behandlungen, Fotos, Einwilligungen und Rechnungen bleiben außen vor, welche Berechtigung die Praxis auch wählt: sie anzufordern ergibt 403.

Kurzanleitung

Fünf Schritte zum ersten Aufruf

  1. Du schreibst uns, was dein Programm macht

    Von der Partnerseite aus, mit den Berechtigungen, die du brauchst.

  2. Die Praxis aktiviert den Zugriff

    Wer es verwaltet, erstellt einen Schlüssel oder verbindet deine registrierte App.

  3. Fordere das Token an

    Es ist eine Stunde gültig: Fordere es einmal an und verwende es wieder.

  4. Du rufst die FHIR R4 APIs auf

    Nur auf die Adressen der Praxis, die dir den Zugriff gegeben hat.

  5. Du erhältst die Benachrichtigungen

    Eine signierte Nachricht, wenn ein Termin entsteht, sich ändert oder abgesagt wird.

Beispiele

Freie Zeiten lesen und Benachrichtigungen erhalten

Die vollständige technische Anleitung mit allen Antworten und Fehlern schicken wir an die von der Praxis beauftragte Person.

Freie Zeiten lesen

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

Die Benachrichtigung, die bei deinem Programm eintrifft

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/…" }
}

Der Header X-Fibonacci-Firma enthält die Uhrzeit und die Signatur des Bodys: Du prüfst sie mit dem Secret, das die Praxis nur einmal sieht.

Ohne Code zu schreiben: Zapier, Make, n8n und MCP nutzen dieselben Zugänge, mit denselben Schlüsseln. Die heutigen Anbindungen

Häufige Fragen

Die Fragen derer, die die Anbindung programmieren

Welche Standards verwendet ihr?

FHIR R4 für die Daten und OAuth 2.0 mit Client Credentials für den Zugriff. Die Benachrichtigungen sind signierte JSON-Nachrichten.

Kann ich Patienten nach Nachnamen suchen?

Nein. Patienten- und Terminlisten lassen sich nicht durchsuchen: Eine Suche nach Nachnamen würde ohnehin den Nachnamen preisgeben. Die Codes erhältst du mit den Benachrichtigungen oder über die Zeiten.

Was passiert, wenn die Praxis den Schlüssel widerruft?

Das Token, das du hast, funktioniert sofort nicht mehr, nicht erst beim Ablauf, und ein neues kannst du nicht mehr anfordern.

Gibt es Anfragegrenzen?

Ja. Das Token gilt eine Stunde: Fordere es einmal an und verwende es wieder. Überschreitest du das Limit, antwortet die Token-Adresse mit 429.

Braucht es einen Vertrag mit der Praxis?

In der Regel ja: Ein Programm, das diese Daten im Auftrag der Praxis verarbeitet, ist ein Auftragsverarbeiter, und es braucht die Vereinbarung nach Artikel 28 des GDPR zwischen dir und der Praxis.

Willst du dein Produkt mit Fibonacci verbinden?

Schreib uns, was es tut und welche Daten es braucht. Die Anbindung entwerfen wir gemeinsam.