API-Token und Entwicklerzugriff

Deskwoot stellt eine REST API bereit, über die du per Code auf deine Supportdaten und Abläufe zugreifst. Ob du eigene Integrationen baust, Ticketdaten mit internen Tools abgleichst oder wiederkehrende Aufgaben automatisierst: Mit API-Tokens meldest du dich sicher an, ohne deine Zugangsdaten weiterzugeben. Diese Anleitung zeigt dir, wie du Tokens erstellst, deinen ersten API-Aufruf machst und dein Konto dabei sicher hältst.

Die REST API ist eine Enterprise-Funktion. Die 7-tägige Enterprise-Testphase, mit der jedes neue Konto startet, enthält keine API-Tokens; dafür brauchst du einen aktiven Enterprise-Tarif. Wenn du in einem niedrigeren Tarif bist und API-Zugriff brauchst, musst du auf Enterprise wechseln. Einen ausführlicheren Überblick darüber, was die API abdeckt, findest du im Überblick zur REST API.

Wie erstelle ich einen API-Token?

1. Melde dich bei deinem Deskwoot-Konto an und gehe zu Einstellungen > API-Token.
2. Klicke auf Token erstellen. Nur Administratoren können Tokens erstellen.
3. Gib dem Token einen aussagekräftigen Namen (zum Beispiel CRM-Abgleich, Produktion), damit du später weißt, wofür er gedacht ist.
4. Wähle die Berechtigungen, die der Token haben soll. Gib nur die Zugriffe frei, die deine Integration wirklich braucht. Optional kannst du ein Ablaufdatum festlegen.
5. Bestätige und kopiere den Token sofort. Aus Sicherheitsgründen wird der vollständige Token nur einmal angezeigt.

Wie nutze ich die API?

Alle API-Anfragen gehen an diese Basis-URL:

https://deskwoot.com/api/v1/

Sende deinen API-Token bei jeder Anfrage im Authorization-Header mit:

Authorization: Bearer YOUR_TOKEN

Beispielanfrage

Ein einfacher cURL-Aufruf zum Testen deiner Verbindung sieht so aus:

curl -H "Authorization: Bearer YOUR_TOKEN" https://deskwoot.com/api/v1/me

Ist der Token gültig, liefert die API deine Konto-ID und die Berechtigungen des Tokens zurück. Wenn nicht, bekommst du einen Authentifizierungsfehler. Alle Endpunkte findest du in der API-Dokumentation.

Worauf solltest du achten?

• So wenig Zugriff wie nötig. Gib jedem Token nur die Berechtigungen, die er braucht. Vermeide Tokens mit vollem Zugriff, wenn du ihn nicht wirklich brauchst.
• Tokens regelmäßig erneuern. Widerrufe alte Tokens von Zeit zu Zeit und erstelle neue, besonders wenn Teammitglieder ihre Rolle wechseln oder das Team verlassen.
• Tokens sicher speichern. Bewahre Tokens in Umgebungsvariablen oder einem Secrets-Manager auf. Schreib sie nie fest in Code, der im Browser läuft, und leg sie nie in der Versionsverwaltung ab.
• Aussagekräftige Namen verwenden. Wenn du Tokens nach Integration oder Umgebung benennst, behältst du leicht den Überblick.
• Nutzung im Blick behalten. Prüfe deine aktiven Tokens regelmäßig unter Einstellungen > API-Token und lösche alle, die nicht mehr gebraucht werden.

Wie behebe ich Token-Fehler?

• 401 Unauthorized: Prüfe, ob der Token richtig kopiert wurde, nicht widerrufen ist und mit dem Präfix Bearer im Header steht.
• 403 Forbidden: Dem Token fehlen wahrscheinlich die Berechtigungen für den Endpunkt, den du aufrufst. Erstelle einen neuen Token mit den passenden Berechtigungen und widerrufe den alten. Ein 403 kommt auch, wenn dein Workspace nicht mehr im Enterprise-Tarif ist.
• Zu viele Anfragen: Bekommst du Fehler wegen eines Limits, ruf die API seltener auf oder baue in deinen Code ein exponentielles Backoff ein.

Häufige Fragen