GraphQL · API-Schlüssel · Webhooks
Die API, mit der die App selbst arbeitet. Für euch geöffnet.
Alles, was eine Person in docket tut, tut sie über diese API: Zeit buchen, Tickets anlegen, Rechnungen lesen. Mit einem persönlichen Schlüssel tun das auch eure Skripte und Automationen, und Webhooks melden ihnen, wenn etwas passiert.
Im Preis enthalten. Ein Admin schaltet die API für den Workspace ein.
Anmelden, und was ein Schlüssel darf.
POST https://euerworkspace.docket.rocks/graphql
Authorization: Bearer dkt_…
Content-Type: application/json
{ "query": "{ viewer { id firstname role } }" }
Ein Schlüssel ist eine Person.
Jede Person legt in ihrem Profil eigene Schlüssel an. Ein Schlüssel sieht und darf, was ihre Rolle in der App darf, nicht mehr: Der Schlüssel einer Zeiterfasserin sieht ihre Zeiten, der eines Projektmanagers auch Rechnungen.
Was kein Schlüssel kann.
Workspace-Einstellungen, Nutzer und Rollen, die Verbindungen zu Jira und KI-Apps sowie Schlüssel und Webhooks selbst ändert ihr nur angemeldet in der App. Ein verlorener Schlüssel kann Zeit buchen, aber sich nicht zum Admin machen.
Webhooks statt Nachfragen.
docket schickt eurer Adresse ein signiertes Ereignis, wenn eine Rechnung veröffentlicht oder bezahlt, ein Ticket angelegt oder Zeit gebucht wird. n8n, Make und Zapier nehmen es mit ihren Webhook-Bausteinen entgegen.
Für eigene Integrationen: der Schlüssel, nicht das Passwort.
Die Web-App und die Mac-App melden sich mit E-Mail, Passwort und zweitem Faktor an. Dieser Weg gehört dockets eigenen Programmen und kann sich ändern. Baut eure Integration auf API-Schlüssel: Sie lassen sich einzeln löschen, und niemand muss ein Passwort in ein Skript schreiben.
Die Referenz, direkt aus dem Schema.
Die 84 Abfragen und 151 Mutationen, die ein Schlüssel aufrufen kann, mit dem, was sie tun, wer sie aufrufen darf, ihren Argumenten und einem Beispielaufruf mit Antwort, dazu jedes Objekt, das sie zurückgeben. In der Doku, mit einer Liste der Namen zum Filtern.
Kurz gefragt, kurz geantwortet.
Gibt es auch eine REST-API?
Nein, nur GraphQL. Jedes Automationswerkzeug mit einem HTTP-Baustein kann sie aufrufen: Ein Aufruf ist ein POST mit einem JSON-Body. Der Leitfaden zeigt die üblichen Aufrufe zum Kopieren.
Kostet die API extra?
Nein. API-Schlüssel und Webhooks sind in jedem Workspace enthalten. Ein Admin schaltet die API ein, danach legt jede Person ihre Schlüssel selbst an.
Wie viele Anfragen sind erlaubt?
120 Anfragen pro Minute je Schlüssel. Darüber antwortet docket mit dem Status 429, und ihr versucht es nach einer Pause erneut.
Bleibt die API stabil?
Es ist die API der App und wächst mit ihr. Ein Feld, das wegfällt, wird im Schema vorher als veraltet markiert. Eine Versionsnummer gibt es nicht.
Können wir gefahrlos testen?
Ja, in einem eigenen Test-Workspace: Die 14 Tage kostenlos reichen, um eure Automation gegen echte Antworten zu bauen. Webhooks lassen sich in der App mit einem Testereignis auslösen.
Gibt es eine fertige App für Zapier, Make oder n8n?
Noch nicht. Alle drei verbinden sich über ihre allgemeinen Bausteine: einen Webhook-Auslöser für Ereignisse und einen HTTP- oder GraphQL-Baustein für Aufrufe.
Eure Tools. An docket angeschlossen.
14 Tage kostenlos testenOhne Karte. Mit Beispielen: der API-Leitfaden in der Hilfe. Fragen vorab? info@docket.rocks.
