Die Nutzung unserer API erfordert Vorwissen/Erfahrung in APIs und wie man damit arbeitet. Dieser Artikel erklärt, was die Teamtailor API ist und wie du damit arbeiten kannst.
Was ist die Teamtailor API und was kann sie?
Unsere offene Teamtailor API folgt der JSON API Specification und kann genutzt werden, um Informationen in dein Teamtailor-Konto zu importieren, zu bearbeiten oder daraus zu exportieren. Das kann alles Mögliche sein, zum Beispiel das Abrufen einer Liste von Stellen, das Aktualisieren einer Stelle, das Aktualisieren eines Benutzers oder sogar das Anlegen eines Benutzers.
Teamtailor stellt verschiedene Regionen für Datenverarbeitung und -speicherung bereit. Die API-URL, die du für deine API-Aufrufe nutzt, hängt von der Region ab, in der dein Konto gespeichert ist.
Region Europa (Irland): api.teamtailor.com
Region Nordamerika (Oregon): api.na.teamtailor.com
Region Asien-Pazifik (Australien): api.au.teamtailor.com
Erste Schritte
Um unsere API nutzen zu können, muss in deinem Teamtailor-Konto unter Einstellungen → Integrationen → API-Schlüssel ein API-Schlüssel erstellt werden. Beachte, dass diese Seite nur für Benutzer mit Unternehmens-Admin Rolle zugänglich ist.
Hier kannst du sowohl neue Schlüssel erstellen als auch bestehende löschen. Beachte, dass ein API-Schlüssel nach der Erstellung nicht mehr bearbeitet, sondern nur gelöscht werden kann.
Um einen API-Schlüssel zu erstellen, klicke auf + Neuer API-Schlüssel in der oberen rechten Ecke.
Es gibt drei verschiedene Arten von Schlüsseln mit unterschiedlichen Berechtigungen und Typen. Diese sind alle in unserer Dokumentation hier erklärt und lauten wie folgt:
Berechtigungen:
Öffentlich - Zugriff auf alle öffentlichen Daten, die auf der Karriereseite verfügbar sind
Intern – öffentliche und interne Daten (z. B. nicht gelistete/interne Stellen, Abteilungen, Standorte)
Admin - Zugriff auf alles in einem Konto
Typen:
Lesen - nur Informationen abrufen und ‚lesen‘
Schreiben - nur neue Informationen erstellen
Lesen/Schreiben - kann beides
Anwendungsbeispiel
Wenn du zum Beispiel über unsere API eine Liste von Stellen abrufst und nur veröffentlichte Stellen holen möchtest, ist ein Public Read-Schlüssel ideal, denn der gibt dir Zugriff auf öffentliche Daten der Karriereseite, wie veröffentlichte Stellen. Möchtest du stattdessen eine Liste aller Standorte abrufen, egal ob öffentlich oder nicht, brauchst du einen Schlüssel mit mindestens Internal Read-Rechten.
Manche Daten sind aus Sicherheitsgründen stark eingeschränkt (z. B. Bewerberinformationen) und nur zugänglich mit einem Schlüssel, der Admin-Berechtigungen hat. Wenn das der Fall ist, wird dies immer in der API-Dokumentation angegeben.
Unterstützung/Support
In unserer Dokumentation zu allen verfügbaren Endpunkten findest du alles, was du für Aktionen brauchst, inklusive Beispiele, die du bei Bedarf testen kannst.
Wenn du allgemeine Fragen zur API-Dokumentation hast, melde dich gern bei unserem Support unter support@teamtailor.com. Bitte beachte jedoch, dass wir keinen Support für die API-Implementierung anbieten.
Wenn etwas nicht in der Dokumentation steht, ist es sehr wahrscheinlich nicht für die Implementierung verfügbar. Benutzerdefinierte Skripte oder weitere Integrationen können mit den Anfragen, die in unseren öffentlichen API-Skripten verfügbar sind, kombiniert werden. Wie genau ihr das angeht, liegt allerdings ganz bei euch.
🤖 Dieser Artikel wurde mithilfe von KI übersetzt. Bitte lass es uns wissen, falls dir etwas fehlerhaft erscheint.