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)?
Vacation Tracker
Deutsch
Zu vacationtracker.io vacationtracker.io
Zurück zu Das Wichtigste Zurück zu Leistung und Erholung

Das Wichtigste

Schritt-für-Schritt-Leitfäden, um Ihren Bereich einzurichten, Ihre Regeln anzupassen, Ihre Tools zu verbinden und Ihr Konto zu verwalten.

Leistung und Erholung

Nutzen Sie die Energieniveaus der Erholungsfunktion und Urlaubsanalysen, damit Ihr Team auf Spitzenenergie bleibt.

Ihren Bereich einrichten Ihre Regeln anpassen Ihre Verbindungen Kontoverwaltung
Leistung stärken Zusammenhang zwischen Erholung und Leistung

Letzte Aktualisierung am November 2, 2026

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

  1. Melden Sie sich unter app.vacationtracker.io/signin bei Ihrem Vacation Tracker Konto an.
  2. Öffnen Sie im linken Menü Integrationen (unter Arbeitsbereich-Einstellungen).
  3. Klicken Sie auf die Karte API. Daraufhin öffnet sich die Seite Offene API.
  4. Klicken Sie im Abschnitt API-Schlüssel auf API-Schlüssel erstellen.
  5. Geben Sie einen Schlüsselnamen ein. Diesen Namen sehen nur Personen in Ihrem Unternehmen.
  6. 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.
  7. Wählen Sie unter Berechtigungen eine Vorlage und passen Sie sie bei Bedarf an (siehe unten).
  8. Legen Sie unter Ablauf fest, wann der Schlüssel abläuft: in 30 Tagen, in 90 Tagen, in 1 Jahr (empfohlen) oder nie.
  9. Prüfen Sie die Zusammenfassung und klicken Sie auf API-Schlüssel erstellen.
  10. 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. 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

  1. Gehen Sie auf der Seite des Add-ons „Offene API“ zu Webhooks und klicken Sie auf Webhooks verwalten.
  2. Klicken Sie auf Webhook hinzufügen.
  3. Geben Sie die Endpunkt-URL ein, die die Ereignisse empfangen soll. Sie muss HTTPS verwenden.
  4. Wählen Sie unter Ereignisse die Option Urlaubsentscheidungen, Alle Abwesenheitsaktivitäten, Vollständige Kopie synchron halten oder Benutzerdefiniert, um die Ereignisse selbst auszuwählen.
  5. 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 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.

Häufige Fragen

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.

Nein. Das Add-on „Offene API“ ist in den Plänen Core und Complete ohne Aufpreis enthalten.

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? Wie verbinde ich Vacation Tracker über den MCP-Server mit meinen KI-Tools? Wie exportiere ich einen Bericht über Urlaubsanträge (Urlaubsverlauf)?
Brauchen Sie Hilfe?
Benutzer: Wenn Sie Fragen haben, schreiben Sie uns jederzeit an hello@vacationtracker.io.
Administratoren und Genehmiger: Sie erreichen uns per Live-Chat montags bis freitags von 9 bis 17 Uhr (EST) oder jederzeit per E-Mail an hello@vacationtracker.io.

War dieser Artikel hilfreich?

Vielen Dank für Ihr Feedback!

Auf dieser Seite

Noch Fragen? Wir zeigen Ihnen, wie Vacation Tracker helfen kann.