Utiliser notre API requiert une connaissance préalable des API et de 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 inclure n’importe quelle action, comme récupérer une liste d’offres, mettre à jour une offre, modifier un utilisateur, voire créer un utilisateur.
Teamtailor propose plusieurs régions pour le traitement et le stockage des données. L’URL d’API que vous utilisez 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, une clé API doit être générée dans Paramètres → Intégrations → Clés API de votre compte Teamtailor. Notez que cette page est uniquement accessible aux utilisateurs disposant d’un accès Admin Entreprise.
Ici, vous pouvez à la fois créer de nouvelles clés et supprimer celles existantes. Notez qu’une fois créée, une clé API ne peut pas être modifiée, mais seulement supprimée.
Pour créer une clé API, cliquez sur + Nouvelle clé API dans le coin supérieur droit.
Il existe trois types de clés, avec des permissions et portées différentes. Ils sont tous expliqués dans notre documentation ici, et se présentent comme suit :
Autorisations :
Public – accès à toutes les données publiques disponibles sur le site carrière
Interne – données publiques + internes (par exemple, offres non listées/internes, départements, localisations)
Admin – accès à tout le contenu d’un compte
Types :
Lire – uniquement récupérer et consulter les informations
É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 ne souhaitez que les offres publiées, il est conseillé d’utiliser une clé Lecture publique, qui donne accès aux données publiques du site carrière, comme les offres publiées. Si vous souhaitez plutôt pouvoir récupérer une liste de toutes les localisations, publiques ou non, il vous faudra une clé avec au minimum les permissions Lecture interne.
Certaines données sont très restreintes pour des raisons de sécurité (par exemple, les informations données par les candidats) et ne sont accessibles qu’avec une clé possédant le rôle/permissions Admin. Si c’est le cas, c’est toujours indiqué dans la documentation de l’API.
Assistance
Notre documentation inclut 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 assistance à support@teamtailor.com. Notez cependant que nous n’offrons pas de support 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 requêtes disponibles dans nos scripts d’API publics, mais 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.