Créer une clé d'API

Mis à jour 13 octobre 2026

Une clé d’API est ce que votre page carrières, ou votre ATS, présente pour atteindre vos postes. Elle se crée dans Orbit, s’affiche une seule fois et peut être révoquée à tout moment. Cette page couvre tout le cycle de vie : créer, stocker, faire tourner, révoquer.

Créer la clé

1. Dans Orbit, ouvrez Paramètres → Clés d’API.
2. Choisissez Nouvelle clé.
3. Donnez-lui un libellé qui dit où elle vivra, par exemple page carrières — production. Les clés se distinguent par leur libellé et par leurs quatre derniers caractères : un libellé écrit pour votre futur vous vaut bien dix secondes.
4. Choisissez la portée. Il y en a quatre, et la bonne est la plus étroite qui fasse le travail : une clé qui va plus loin que son travail est une clé qui fait plus de dégâts quand elle fuite.
   • Lecture des offres uniquement — vos postes ouverts et leurs détails. Ce dont une page carrières a besoin.
   • Lecture et gestion des offres — crée, modifie, publie et clôture aussi les postes. Publier place une annonce devant le public : cette portée appartient à un système que vous exploitez, pas à la configuration d’une page. Malgré son nom, elle ne gère pas les offres au sens d’Orbit : cela s’active offre par offre dans Orbit.
   • Présélection — invite vos candidats à des présélections par IA sur des offres gérées, et atteint des données de candidats. L’émettre vaut consentement du compte aux présélections supplémentaires au-delà de celles incluses dans une offre, jusqu’à la limite mensuelle fixée dans Orbit → Facturation : elle appartient donc à un serveur que vous contrôlez. Voir Présélectionner un candidat.
   • Recevoir des candidatures — envoie à Wipperoz les candidatures et les candidats que vos propres pages ont recueillis, et lit l’état de chaque candidature. Elle porte le consentement des candidats : un Administrateur ne peut la créer qu’après avoir accepté l’Avenant de traitement des données pour l’API, ci-dessous. Voir Recevoir des candidatures depuis votre propre page carrières.
5. Choisissez Créer.

L’Avenant de traitement des données pour l’API

Sur la page de candidature hébergée, Wipperoz présente au candidat son texte de consentement et enregistre son acceptation. Quand la candidature se passe sur votre page, c’est vous qui affichez ce texte et enregistrez cette acceptation, et l’Avenant de traitement des données pour l’API est là où votre compte s’y engage : afficher le texte sans modification, envoyer un reçu sincère, attester d’une base légale pour chaque candidat que vous envoyez, et garder la clé sur vos serveurs.

Un Administrateur l’accepte, une fois, dans Orbit → Paramètres → Clés d’API ; Wipperoz enregistre la version, l’Administrateur et l’heure dans l’historique des consentements du compte, à côté de l’Accord de traitement. Jusque-là, Orbit refuse de créer une clé avec Recevoir des candidatures et dit pourquoi. Une nouvelle version de l’avenant demande à un Administrateur de l’accepter avant la création de la prochaine clé Recevoir des candidatures ; les clés existantes continuent de fonctionner.

L’affichage unique

La clé complète est affichée une seule fois. Copiez-la, placez-la là où vit la configuration de votre site, et seulement ensuite fermez la boîte de dialogue.

Elle ne peut pas être réaffichée, et ce n’est pas une permission que nous pourrions accorder plus tard : Wipperoz stocke une empreinte de la clé, jamais la clé elle-même. La liste dans Paramètres affiche le libellé, les quatre derniers caractères, qui l’a créée et sa dernière utilisation. Elle n’affiche jamais la valeur.

La stocker

Traitez-la comme n’importe quel autre secret. La convention dans cette documentation est une variable d’environnement :

export ORBIT_API_KEY="…la clé que vous avez copiée…"

Faire tourner sans interruption

Rien ne limite un compte à une seule clé, et c’est en faisant se chevaucher deux clés qu’une rotation se passe sans que votre page carrières s’éteigne. L’ordre compte :

1. Créez la clé de remplacement.
2. Mettez à jour votre site pour qu’il l’utilise, et vérifiez qu’il lit bien les postes.
3. Révoquez l’ancienne clé.

Révoquer d’abord et créer ensuite met votre page carrières hors service pendant toute la durée du remplacement.

Révoquer

La révocation est immédiate et irréversible. Une requête faite avec une clé révoquée est refusée dès la requête suivante ; il n’y a aucun cache à attendre. Avant de révoquer, regardez la dernière utilisation dans la liste : une clé utilisée il y a quelques minutes est une clé dont quelque chose dépend en ce moment, et le geste sûr est de la faire tourner comme ci-dessus plutôt que de la révoquer d’emblée.

Une clé jamais utilisée signale généralement une intégration commencée puis abandonnée, pas une intégration au repos. C’est la clé la plus sûre à révoquer.

Suite

Faites votre première requête avec la clé sur la page suivante.