API-Übersicht

Die Dentero-API ist eine kleine, schreibgeschützte HTTP-API, mit der eine Praxis auf ihre Aufzeichnungen und die dazugehörige KI-generierte Dokumentation zugreifen kann.

Basis-URL

https://app.dentero.de/api/v1

Alle Antworten sind JSON.

Authentifizierung

Die API verwendet Praxis-API-Tokens. Ein Praxismanager erstellt ein Token in der Dentero-App unter den Praxiseinstellungen. Jedes Token gewährt Lesezugriff auf die Daten dieser Praxis.

Senden Sie das Token als Bearer-Token im Authorization-Header:

curl https://app.dentero.de/api/v1/recordings \
  -H "Authorization: Bearer dt_your_token_here"

Anfragen ohne gültiges Token erhalten 401 Unauthorized:

{ "error": "unauthorized" }

Tokens werden nur einmal bei der Erstellung angezeigt. Bewahren Sie sie sicher auf und widerrufen Sie jedes Token, das möglicherweise offengelegt wurde — widerrufene Tokens funktionieren sofort nicht mehr.

Paginierung

Listen-Endpunkte sind paginiert und liefern neben den Daten ein pagination-Objekt:

{
  "recordings": [],
  "pagination": {
    "page": 1,
    "limit": 20,
    "count": 137,
    "pages": 7,
    "next": 2,
    "prev": null
  }
}

Verwenden Sie den Query-Parameter limit, um die Seitengröße zu ändern, und page zum Blättern.

Fehler

Fehler werden mit dem passenden HTTP-Status und einem JSON-Body zurückgegeben:

Endpunkte

In diesem Abschnitt finden Sie die Referenzseiten für die verfügbaren Endpunkte.