# Ein API-Token erstellen

Ein persönliches API-Token für Skripte und Tools wie rclone erstellen, seine Zugriffsrechte festlegen und es widerrufen, wenn Sie es nicht mehr brauchen.

Aktualisiert: 2026-10-19  
Quelle: https://drime.cloud/de/support/integrations-and-api/api-tokens

Mit einem API-Token kann ein Skript oder ein Tool wie rclone auf Ihr Drime-Konto zugreifen, ohne Ihr Passwort zu kennen. Sie legen fest, was jedes Token darf, und können es jederzeit widerrufen.

Persönliche Tokens sind für Ihre eigenen Skripte, Backups und Tools gedacht, die mit Ihrem eigenen Konto arbeiten. Eine App, die andere Drime-Nutzer mit ihrem Konto verbinden, verwendet stattdessen OAuth und darf nie nach deren Passwort fragen: siehe die [Dokumentation der Drime-API](https://docs.drime.cloud/authentication).

## Ein Token erstellen

1. Klicken Sie oben rechts auf Ihren Avatar und dann auf **Einstellungen**.

2. Klicken Sie auf **Entwickler**.

3. Klicken Sie unter **API-Zugriffstoken** auf **Token erstellen**.

   ![Die Einstellungen im Bereich Entwickler mit dem Abschnitt API-Zugriffstoken und der Schaltfläche Token erstellen](https://drime.cloud/media/01M5A9VZ3EXT7ZMZHRBK5B9MS0/7ada18a14def-web-settings-developers-tokens.png)

4. Geben Sie dem Token unter **Token-Name** einen Namen, an dem Sie es wiedererkennen.

   Nennen Sie das Tool oder den Computer, der es verwendet, zum Beispiel „rclone auf meinem NAS“. Der Name muss 3 bis 100 Zeichen lang sein.

5. Legen Sie unter **Berechtigungen** fest, was das Token darf.

   - **Alle**: Vollzugriff auf alle Ressourcen.
   - **Nur lesen**: reiner Lesezugriff auf alle Ressourcen.
   - **Eingeschränkt**: Zugriff nur auf die Ressourcen, die Sie auswählen, jeweils mit **Kein Zugriff**, **Gelesen** oder **Schreiben**.

   Siehe [Die passenden Berechtigungen wählen](#permissions).

   ![Der Dialog Neuen Token erstellen mit einem Token-Namen und den Tabs unter Berechtigungen](https://drime.cloud/media/01M59T977CYEFV0EGJSEE6Y0F7/1767ae179cc0-web-settings-developers-token-dialog.png)

6. Klicken Sie auf **Erstellen**.

7. Klicken Sie auf **Kopieren**, um das Token zu kopieren, und dann auf **Fertig**.

   Sobald das Token in Ihrer Zwischenablage ist, zeigt die Schaltfläche **Kopiert!** an.

   ![Das neue, einmalig angezeigte Token mit der Schaltfläche Kopieren und dem Hinweis, es an einem sicheren Ort aufzubewahren](https://drime.cloud/media/01M5A9VVN2VHMPSB1CPTQWH2G4/45e6a99fae24-web-settings-developers-token-shown-once.png)

> **Wichtig**
>
> Das Token wird nur ein einziges Mal angezeigt: **Bewahren Sie das Token an einem sicheren Ort auf. Nachdem dieser Dialog geschlossen wurde, ist das Token nicht mehr einsehbar.** Speichern Sie es sofort in einem Passwort-Manager oder in der Konfiguration Ihres Tools. Wenn Sie es verlieren, löschen Sie es und erstellen Sie ein neues.

Das Token erscheint anschließend unter **API-Zugriffstoken** und funktioniert sofort. Es läuft nicht ab: Es funktioniert, bis Sie es löschen.

## Die passenden Berechtigungen wählen

Geben Sie einem Token nur die Rechte, die es braucht.

| Berechtigung | Was das Token kann |
| --- | --- |
| **Alle** | Alles, was Ihr Konto über die API tun kann. |
| **Nur lesen** | Alle unten aufgeführten Ressourcen lesen, aber nichts ändern. |
| **Eingeschränkt** | Nur auf die Ressourcen zugreifen, die Sie auf **Gelesen** oder **Schreiben** setzen. Alles, was auf **Kein Zugriff** bleibt, wird abgelehnt. |

Bei einem Token mit **Eingeschränkt** stehen diese Ressourcen zur Auswahl: **Dateien** (einschließlich Versionen und Papierkorb), **Ordner**, **Freigabe**, **Arbeitsbereiche**, **Vault**, **Signieren**, **Whiteboards**, **Dateinanforderungen**, **Senden & Verfolgen**, **Kontakte**, **Tags** und **Analysen**. **Analysen** (die Speichernutzung) kann nur gelesen werden, daher lauten die Optionen dort **Kein Zugriff** und **Zugriff**. Bewegen Sie den Mauszeiger auf das Hilfesymbol neben einer Ressource, um zu sehen, was sie umfasst.

Nur ein Token mit **Alle** kann auf Ihre Konto-, Sicherheits- und Abrechnungseinstellungen zugreifen. Tokens mit **Nur lesen** oder **Eingeschränkt** können das nie.

Die Berechtigungen eines Tokens lassen sich nach dem Erstellen nicht mehr ändern. Um sie zu ändern, erstellen Sie ein neues Token mit den passenden Berechtigungen, aktualisieren Ihr Tool und löschen dann das alte Token.

## Das Token verwenden

Senden Sie das Token bei jeder Anfrage im `Authorization`-Header mit:

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

Der Link **Dokumentation** neben **API-Zugriffstoken** öffnet die [Dokumentation der Drime-API](https://docs.drime.cloud/authentication). Wie Sie ein Token mit rclone verwenden, lesen Sie unter [Rclone, Drime CLI und WebDAV](https://drime.cloud/de/support/integrations-and-api/rclone-cli-and-webdav).

## Ihre Tokens anzeigen und löschen

**API-Zugriffstoken** listet die Tokens auf, die Sie erstellt haben, und die Tokens, die die Drime-Apps für sich selbst erstellen: Drime Desktop, Drime Mobile und die Browsererweiterung. Jede Zeile zeigt:

- den Namen des Tokens oder die App und ihre Plattform, zum Beispiel **Desktop-App · Windows**;
- seine Berechtigung, zum Beispiel **Vollzugriff**;
- wann es zuletzt verwendet wurde, oder **Nie verwendet**.

Wenn Sie noch kein Token haben, zeigt der Abschnitt **Sie haben noch keine persönlichen Zugriffstoken** an.

So widerrufen Sie ein Token:

1. Klicken Sie am Ende seiner Zeile auf **Token löschen** (das Papierkorb-Symbol).

   ![Der Bestätigungsdialog Token löschen?](https://drime.cloud/media/01M5A9VQDKFSB11N67Y0PAC592/fe208ec6869e-web-settings-developers-delete-token.png)

2. Klicken Sie zur Bestätigung auf **Löschen**.

   Der Dialog warnt: **Dieses Token wird sofort und dauerhaft gelöscht. Nach dem Löschen kann es nicht mehr für API-Anfragen verwendet werden.** Die Meldung **Token gelöscht** erscheint, und jedes Tool, das dieses Token verwendet, funktioniert ab sofort nicht mehr.

Die Drime-Apps können Sie auch unter [Sitzungen und Geräte anzeigen und abmelden](https://drime.cloud/de/support/account-and-settings/sessions-and-devices) abmelden.

## Wenn es nicht funktioniert

| Was Sie sehen | Was Sie tun können |
| --- | --- |
| **API-Zugriffstoken** fehlt unter **Entwickler** | Der API-Zugriff ist für Ihr Konto nicht aktiviert. [Kontaktieren Sie den Drime-Support](https://drime.cloud/de/support/getting-started/contact-drime-support). |
| Sie haben das Token verloren | Es kann nicht erneut angezeigt werden. Löschen Sie es und erstellen Sie ein neues. |
| **Erstellen** zeigt einen Fehler unter **Token-Name** | Der Name muss 3 bis 100 Zeichen lang sein. |
| `401` mit `Unauthenticated.` | Das Token fehlt, ist falsch oder wurde gelöscht. Prüfen Sie den Header `Authorization: Bearer` oder erstellen Sie ein neues Token. |
| `403` mit `This API key is missing the required scope: files.write` (oder einer anderen Ressource) | Das Token hat **Nur lesen** oder **Eingeschränkt**, und ihm fehlt diese Ressource. Erstellen Sie ein Token, bei dem diese Ressource auf **Gelesen** oder **Schreiben** steht (die Meldung nennt sie), oder ein Token mit **Alle**. |
| `403` mit `This endpoint cannot be accessed with a restricted API key.` | Dieser Teil der API, etwa die Konto- oder Abrechnungseinstellungen, erfordert ein Token mit **Alle**. |
| `403` mit `This action is unauthorized.` | Ihr Konto selbst darf diese Aktion nicht ausführen, unabhängig vom Token. |

## Nächste Schritte

- [Rclone, Drime CLI und WebDAV](https://drime.cloud/de/support/integrations-and-api/rclone-cli-and-webdav)
- [Sitzungen und Geräte anzeigen und abmelden](https://drime.cloud/de/support/account-and-settings/sessions-and-devices)