SOURCE: Vacation Tracker TITLE: Wie nutze ich die Offene API (OpenAPI)? URL: https://vacationtracker.io/de/wissensdatenbank/wie-nutze-ich-die-offene-api-openapi/ LANG: de PUBLISHED: 2026-10-06 UPDATED: 2026-11-02 READING: 4 min SUMMARY: So erstellen Sie für das Add-on „Offene API“ einen API-Schlüssel mit passenden Berechtigungen, lesen und ändern Ihre Vacation Tracker Daten und richten Webhooks ein. # Wie nutze ich die Offene API (OpenAPI)? # Wie nutze ich die Offene API (OpenAPI)? Unser Add-on „Offene API“ verbindet Vacation Tracker mit Ihren eigenen Tools. Erstellen Sie einen API-Schlüssel, legen Sie fest, was er darf, und nutzen Sie ihn, um Ihre Daten zu lesen und zu ändern oder sich benachrichtigen zu lassen, wenn sich etwas ändert. ### Tutorial ansehen Eine kurze Einführung in das Add-on „Offene API“: ## So erstellen Sie einen API-Schlüssel - Melden Sie sich unter app.vacationtracker.io/signin (https://app.vacationtracker.io/signin) bei Ihrem Vacation Tracker Konto an. - Öffnen Sie im linken Menü Integrationen (unter Arbeitsbereich-Einstellungen). - Klicken Sie auf die Karte API. Daraufhin öffnet sich die Seite Offene API. - Klicken Sie im Abschnitt API-Schlüssel auf API-Schlüssel erstellen. - Geben Sie einen Schlüsselnamen ein. Diesen Namen sehen nur Personen in Ihrem Unternehmen. - Geben Sie optional einen Integrationsnamen ein. Er wird in Vacation Tracker neben jeder Änderung angezeigt, die der Schlüssel vornimmt, zum Beispiel „Genehmigt von Jane (über Payroll-Sync)“. Lassen Sie das Feld leer, um nur den Namen der Person anzuzeigen. - Wählen Sie unter Berechtigungen eine Vorlage und passen Sie sie bei Bedarf an (siehe unten). - Legen Sie unter Ablauf fest, wann der Schlüssel abläuft: in 30 Tagen, in 90 Tagen, in 1 Jahr (empfohlen) oder nie. - Prüfen Sie die Zusammenfassung und klicken Sie auf API-Schlüssel erstellen. - Kopieren Sie den Schlüssel und bewahren Sie ihn an einem sicheren Ort auf. Der vollständige Schlüssel wird nur einmal angezeigt, nämlich beim Erstellen. ## Berechtigungen auswählen Beginnen Sie mit einer Vorlage und passen Sie sie dann an: - Nur lesen: Daten sehen, nichts ändern. Gut geeignet für Berichte und Dashboards. - Urlaubsverwaltung: Urlaub beantragen, hinzufügen und genehmigen. Benutzer und Urlaubsarten lesen. - Arbeitsbereich einrichten: Standorte, Abteilungen, Urlaubsarten, Richtlinien, Feiertage und Benutzer einrichten. - Benutzerdefiniert: jede Berechtigung selbst festlegen. Jede Berechtigung kann auf Kein Zugriff, Lesen oder Lesen & Schreiben gesetzt werden. Das Genehmigen und Ablehnen von Anträgen, das Anzeigen ausgeblendeter Urlaubsartnamen und das Handeln im Namen anderer Benutzer sind eigene Kontrollkästchen. Aktivieren Sie sie nur, wenn Ihr Tool sie benötigt. Ein Schlüssel kann nur das, was Sie selbst in Vacation Tracker dürfen. ## Ihre Schlüssel verwalten Die Tabelle API-Schlüssel listet alle Schlüssel Ihres Arbeitsbereichs mit Eigentümer, Berechtigungen, letzter Nutzung, Ablaufdatum und Status auf. Klicken Sie auf einen Schlüssel, um seine Details zu öffnen. Dort können Sie: - die Nutzung im aktuellen Monat sehen sowie Name und Berechtigungen des Schlüssels bearbeiten. - unter Letzte Aktivität alle Anfragen prüfen, die Daten geändert haben. - auf Schlüssel rotieren klicken, um einen neuen Schlüssel mit demselben Namen und denselben Berechtigungen zu erhalten. Legen Sie fest, ob der alte Schlüssel noch 24 Stunden (empfohlen) oder 7 Tage weiter funktioniert oder sofort deaktiviert wird. - auf Widerrufen klicken, um den Schlüssel endgültig zu deaktivieren. Wir benachrichtigen Sie 14 Tage vor Ablauf eines Schlüssels per E-Mail. ## Ihre erste Anfrage Die Basis-URL lautet https://api.vacationtracker.io/v2. Senden Sie Ihren Schlüssel als Bearer-Token im Header Authorization: curl https://api.vacationtracker.io/v2/departments \ -H "Authorization: Bearer vt_live_..." Ein erfolgreicher Aufruf liefert die Daten unter data. Listen mit weiteren Seiten enthalten außerdem ein nextToken, das Sie zurückgeben, um die nächste Seite abzurufen. { "data": [ ... ], "nextToken": "..." } Wenn etwas schiefgeht, enthält die Antwort einen error mit einem Code, einer Beschreibung und einem Lösungshinweis. Ein fehlender oder unbekannter Schlüssel liefert 401. Ein Schlüssel ohne die für eine Anfrage nötige Berechtigung liefert 403 mit INSUFFICIENT_SCOPE. Vollständige technische Referenz Alle Endpunkte, Parameter, Fehlercodes und Webhook-Ereignisse finden Sie in unserer Entwicklerdokumentation (https://vacationtracker.io/developers/api-v2). Sie können sie auch über die Schaltfläche Dokumentation öffnen auf der Seite des Add-ons „Offene API“ öffnen. ## So fügen Sie einen Webhook hinzu - Gehen Sie auf der Seite des Add-ons „Offene API“ zu Webhooks und klicken Sie auf Webhooks verwalten. - Klicken Sie auf Webhook hinzufügen. - Geben Sie die Endpunkt-URL ein, die die Ereignisse empfangen soll. Sie muss HTTPS verwenden. - Wählen Sie unter Ereignisse die Option Urlaubsentscheidungen, Alle Abwesenheitsaktivitäten, Vollständige Kopie synchron halten oder Benutzerdefiniert, um die Ereignisse selbst auszuwählen. - Klicken Sie auf Webhook hinzufügen. Sie erhalten nur Ereignisse zu Daten, die Sie sehen dürfen. ## Kontingente und Ratenlimits Die Limits gelten pro API-Schlüssel: - Bis zu 30.000 Anfragen pro Monat. - 10 Anfragen pro Sekunde, mit kurzzeitigen Spitzen von bis zu 50 Anfragen. Wenn Ihre Integration mehr benötigt, schreiben Sie an developers@vacationtracker.io (mailto:developers@vacationtracker.io) und nennen Sie Ihren Firmennamen, die Integration und den erwarteten Datenverkehr. Ältere API-Schlüssel Schlüssel, die vor API v2 erstellt wurden, sind unter Legacy-Schlüssel (API v1) aufgeführt. Sie funktionieren weiterhin, können aber nur Daten lesen und funktionieren nicht mit API v2. Um Daten über die API zu ändern, erstellen Sie einen neuen Schlüssel und folgen Sie unserem Migrationsleitfaden (https://vacationtracker.io/developers/api-v2/migration). ## Häufige Fragen Sollte ich die API, Zapier oder den MCP-Server verwenden? Das hängt davon ab, was Sie vorhaben. Die API ist für Ihren eigenen Code und Ihre eigenen Tools gedacht, mit Webhooks, um auf Änderungen zu reagieren. Zapier ist die No-Code-Option. Der MCP-Server verbindet ein KI-Tool wie Claude oder ChatGPT, sodass Sie Fragen in natürlicher Sprache stellen können. Viele Teams nutzen mehr als eine Option. Kostet die API extra? Nein. Das Add-on „Offene API“ ist in den Plänen Core und Complete ohne Aufpreis enthalten. Was passiert, wenn ich einen Schlüssel verliere? Der vollständige Schlüssel wird nur einmal angezeigt und kann nicht wiederhergestellt werden. Öffnen Sie den Schlüssel und klicken Sie auf Schlüssel rotieren, um einen neuen zu erhalten, und aktualisieren Sie dann das Tool, das ihn verwendet. Wenn der alte Schlüssel möglicherweise in falsche Hände geraten ist, lassen Sie ihn sofort deaktivieren. ### Nächste Schritte Wie verbinde ich Vacation Tracker mit Zapier? (https://vacationtracker.io/de/wissensdatenbank/wie-verbinde-ich-vacation-tracker-mit-zapier/) Wie verbinde ich Vacation Tracker über den MCP-Server mit meinen KI-Tools? (https://vacationtracker.io/de/wissensdatenbank/wie-verbinde-ich-vacation-tracker-ueber-den-mcp-server-mit-meinen-ki-tools/) Wie exportiere ich einen Bericht über Urlaubsanträge (Urlaubsverlauf)? (https://vacationtracker.io/de/wissensdatenbank/wie-exportiere-ich-einen-bericht-ueber-urlaubsantraege-urlaubsverlauf/) Benötigen Sie Hilfe? Kontaktieren Sie unser Support-Team per E-Mail oder Chat, montags bis freitags von 9 bis 17 Uhr (EST, US-Ostküstenzeit).