Om onze API te gebruiken vereist dit voorkennis/ervaring met API's en hoe je ermee moet werken. Dit artikel legt uit wat de Teamtailor API is en hoe je aan de slag kunt.
Wat is de Teamtailor API en wat doet het?
Onze Teamtailor open API volgt de JSON API-specificatie en kan worden gebruikt om informatie te importeren, bewerken en exporteren vanuit en naar jouw Teamtailor-account. Dit kan van alles zijn, van het ophalen van een lijst met vacatures, een vacature bijwerken, een gebruiker bijwerken tot het aanmaken van een gebruiker.
Teamtailor biedt verschillende regio's voor gegevensverwerking en -opslag. De API-URL die je gebruikt voor je API-aanroepen hangt af van de regio waar jouw account is opgeslagen.
Europa (Ierland) Regio: api.teamtailor.com
Noord-Amerika (Oregon) Regio: api.na.teamtailor.com
Azië-Pacific (Australië) Regio: api.au.teamtailor.com
Aan de slag
Om onze API te kunnen gebruiken, moet er een API-sleutel worden aangemaakt in Instellingen → Integraties → API-sleutels op jouw Teamtailor-account. Let op dat deze pagina alleen toegankelijk is voor gebruikers met de Bedrijfsbeheerder rol.
Hier kun je zowel nieuwe sleutels maken als bestaande verwijderen. Houd er rekening mee dat zodra een API-sleutel is aangemaakt, deze niet bewerkt kan worden, alleen verwijderd.
Om een API-sleutel aan te maken, klik je op + Nieuwe API-sleutel in de rechterbovenhoek.
Er zijn drie verschillende soorten sleutels, met verschillende toestemmingen en reikwijdten. Deze worden allemaal uitgelegd in onze documentatie hier, en zijn als volgt:
Toestemmingen:
Openbaar - toegang tot alle openbare gegevens die beschikbaar zijn op de carrière site
Intern - publieke en interne gegevens (zoals niet-vermelde/interne vacatures, afdelingen, locaties)
Admin - toegang tot alles in een account
Types:
Lezen - alleen informatie ophalen en ‘lezen’
Schrijven - alleen nieuwe informatie aanmaken
Lezen/Schrijven - kan beide
Voorbeeld van gebruik
Als je bijvoorbeeld via onze API een lijst met vacatures ophaalt en alleen de gepubliceerde vacatures wilt zien, gebruik dan een Publiek Lezen-sleutel. Daarmee krijg je toegang tot publieke gegevens op de carrièresite, zoals gepubliceerde vacatures. Wil je in plaats daarvan een lijst ophalen van alle locaties, openbaar of niet, dan heb je een sleutel nodig met minimaal Interne Lezen-rechten.
Sommige gegevens zijn sterk beveiligd vanwege privacyredenen (zoals informatie over sollicitanten) en zijn alleen toegankelijk met een sleutel met Admin-rechten. Als dat het geval is, wordt dit altijd vermeld in de API-documentatie.
Ondersteuningsteam
In onze documentatie vind je alle beschikbare eindpunten, inclusief alles wat je nodig hebt om acties uit te voeren, voorzien van voorbeelden die je kunt testen wanneer je wilt.
Heb je algemene vragen over de API-documentatie? Neem gerust contact op met onze support via support@teamtailor.com. Let op: wij bieden geen ondersteuning bij API-implementaties.
Als iets niet in de documentatie staat, is het waarschijnlijk niet beschikbaar voor implementatie. Aangepaste scripts of verdere integraties kunnen worden gecombineerd met de verzoeken die beschikbaar zijn in onze openbare API-scripts, maar hoe je dat aanpakt, is helemaal aan de klant zelf.
🤖 Dit artikel is vertaald met behulp van AI. Laat het ons weten als iets niet klopt.