Utiliser notre API demande une certaine expérience préalable avec les API et leur fonctionnement. Cet article explique ce qu’est l’API Teamtailor et comment débuter.
Qu'est-ce que l'API Teamtailor et que fait-elle ?
Notre API ouverte Teamtailor suit la spécification JSON API. Elle permet d’importer, modifier et exporter des informations depuis ou vers un compte Teamtailor. Cela peut concerner n’importe quelle action, comme récupérer une liste d’offres, mettre à jour une offre, modifier un utilisateur, ou même créer un utilisateur.
Teamtailor propose plusieurs régions pour le traitement et le stockage des données. L’URL de l’API utilisée dans vos appels dépend de la région où votre compte est hébergé.
Région Europe (Irlande) : api.teamtailor.com
Région Amérique du Nord (Oregon) : api.na.teamtailor.com
Région Asie-Pacifique (Australie) : api.au.teamtailor.com
Débuter
Pour utiliser notre API, il faut générer une clé API dans Paramètres → Intégrations → Clés API de votre compte Teamtailor. Notez que cette page est uniquement accessible pour les utilisateurs ayant un accès Admin Entreprise.
Ici, vous pouvez à la fois créer de nouvelles clés et supprimer celles qui existent. Notez qu’une fois créée, une clé API ne peut pas être modifiée, seulement supprimée.
Pour créer une clé API, cliquez sur + Nouvelle clé API dans le coin supérieur droit.
Il existe trois types différents de clés, avec différentes autorisations et portées. Tous sont expliqués dans notre documentation ici, et sont les suivants :
Autorisations :
Public - accès à toutes les données publiques disponibles sur le site de carrière
Interne - données publiques + internes (par exemple, offres non listées/internes, départements, localisations)
Admin - accès à tout dans un compte
Types :
Lire - uniquement récupérer des informations et ‘les lire’
Écrire - uniquement créer de nouvelles informations
Lire/Écrire - peut faire les deux
Exemple de cas d'utilisation
Par exemple, si vous récupérez une liste d’offres via notre API et que vous souhaitez seulement celles publiées, il est préférable d’utiliser une clé en Lecture Publique, qui donne accès aux données publiques du site carrière, comme les offres publiées. Si vous souhaitez récupérer toutes les localisations, publiques ou non, la clé doit avoir au minimum les permissions Lecture Interne.
Certaines données sont très restreintes pour des raisons de sécurité (ex. informations sur les candidats) et ne sont accessibles qu’avec une clé possédant le rôle/permissions Admin. Si c'est le cas, cela est toujours indiqué dans la documentation de l'API.
Support
Notre documentation couvre tous les points nécessaires pour chaque action, avec des exemples testables si besoin.
Pour toute question générale sur la documentation de l’API, vous pouvez contacter notre support à support@teamtailor.com. Notez cependant que nous n’offrons pas d’assistance pour l’implémentation de l’API.
Si quelque chose n’est pas indiqué dans la documentation, c’est probablement que ce n’est pas disponible à l’implémentation. Des scripts personnalisés ou d'autres intégrations peuvent être combinés avec les demandes disponibles dans nos scripts d'API publics, cependant, la manière de procéder dépend entièrement du client.
🤖 Cet article est traduit à l’aide de l’IA. Faites-nous savoir si quelque chose vous semble incorrect.