# API-Übersicht (/api)



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 [#basis-url]

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

Alle Antworten sind JSON.

## Authentifizierung [#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:

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

Anfragen ohne gültiges Token erhalten `401 Unauthorized`:

```json
{ "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 [#paginierung]

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

```json
{
  "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]

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

| Status | Body                          | Bedeutung                                                         |
| ------ | ----------------------------- | ----------------------------------------------------------------- |
| `401`  | `{ "error": "unauthorized" }` | Fehlendes, ungültiges, abgelaufenes oder widerrufenes Token       |
| `404`  | `{ "error": "not_found" }`    | Die Ressource existiert nicht oder gehört zu einer anderen Praxis |

## Endpunkte [#endpunkte]

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