Die Nutzung unserer API erfordert Vorwissen/Erfahrung mit APIs und wie man mit ihnen arbeitet. Dieser Artikel erklärt, was die Teamtailor API ist und wie du starten kannst.
Was ist die Teamtailor API und was kann sie?
Unsere offene Teamtailor API folgt der JSON API Specification und kann verwendet werden, um Informationen in dein Teamtailor-Konto zu importieren, zu bearbeiten oder daraus zu exportieren. Das kann alles Mögliche sein: eine Liste von Stellen abrufen, eine Stelle aktualisieren, einen Benutzer aktualisieren oder sogar einen Benutzer anlegen.
Teamtailor stellt verschiedene Regionen für die Datenverarbeitung und -speicherung bereit. Die API-URL, die du für deine API-Aufrufe verwendest, 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 werden kann, nur gelöscht.
Um einen API-Schlüssel zu erstellen, klicke oben rechts auf + Neuer API-Schlüssel.
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 beispielsweise über unsere API eine Liste von Stellen abrufst und nur veröffentlichte Stellen holen möchtest, ist ein Public Read-Schlüssel ideal, denn er 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-Berechtigungen.
Manche Daten sind aus Sicherheitsgründen stark eingeschränkt (z. B. Bewerberinformationen) und nur mit einem Schlüssel zugänglich, 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 für eine Aktion nötig ist, inklusive Beispiele, die du bei Bedarf testen kannst.
Bei allgemeinen Fragen zur API-Dokumentation kannst du dich gern an unseren Support unter support@teamtailor.com wenden. 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.