Vue d'ensemble

Mis à jour 8 septembre 2026

L’API Orbit permet à un compte de lire ses propres offres et de les placer où il le souhaite : une page carrières sur votre propre domaine, un intranet, le site d’un partenaire. Wipperoz est l’outil de production ; l’origine, c’est vous. Votre domaine garde la valeur en référencement, votre marque garde le candidat, et nous ne nous plaçons pas entre vous et vos recrutements.

Ce qu’elle fait

• Elle lit vos offres. GET /v1/jobs renvoie les postes que votre compte a publiés, en signalant ceux qui sont clos ou expirés, afin qu’une page que vous avez construite affiche son propre état de clôture plutôt que de casser des liens déjà publiés.
• Elle confie les candidats à la page de candidature hébergée. Chaque offre porte un applyLink. Envoyez-y les candidats. La page de candidature enregistre qu’ils viennent de votre site, ce qui rend les candidatures de votre page carrières séparables de celles de Wipperoz dans vos statistiques.
• Elle reçoit vos offres. POST /v1/jobs crée un poste depuis votre propre système — un ATS, un outil interne — sous forme de brouillon, et POST /v1/jobs/{jobId}/publish le met en ligne. Modifier et clôturer sont là aussi, pour qu’un poste qui change en amont puisse changer ici.
• Elle reste la vôtre. Chaque réponse est limitée au compte dont la clé a fait la requête. Il n’y a ni lecture ni écriture entre comptes, ni endpoint « toutes les offres ».

Ce qu’elle ne fait pas

• Recevoir des candidatures via l’API. Le consentement qu’un candidat donne sur la page de candidature hébergée est ce qui permet à Wipperoz de créer son CV Virtuel et de lui envoyer une invitation à le revendiquer. Un formulaire que vous auriez construit et qui nous enverrait des données nous ferait agir sur un consentement que nous n’avons jamais vu. Faites un lien vers applyLink ; c’est toute la conception.
• Détenir vos identifiants de jobboards ou publier à votre place. La diffusion vers les jobboards est un flux vers lequel vous pointez un jobboard, pas des identifiants que vous nous confiez.
• Publier sans qu’on le lui demande. Créer un poste et le publier sont deux appels, parce que publier consomme vos crédits. Rien ne passe en ligne, ni ne coûte quoi que ce soit, sur un appel que vous n’avez pas fait.

À qui elle s’adresse

• Une personne du recrutement ou de l’ingénierie qui relie une page carrières aux postes qu’un compte publie dans Orbit.
• Une agence qui évalue si Orbit s’intègre à un flux de travail ATS ou MCP existant.

Ce qu’il vous faut

1. Un compte Orbit avec au moins un poste publié.
2. Une clé d’API créée dans Orbit → Paramètres → Clés d’API, avec la portée qui correspond au travail : lecture des offres pour une page carrières, lecture et gestion des offres pour publier des postes également. La page suivante détaille la marche à suivre.

URL de base et versions

Chaque chemin commence par /v1. Une API publique consommée par les sites d’autres personnes ne peut pas changer en place : une rupture de compatibilité arrivera donc sous /v2, /v1 continuant de répondre.