Utiliser l'API Jobpass pour recevoir des candidatures directement dans ses outils

Nous mettons une API dédiée aux recruteurs pour leur permettre de recevoir les candidatures Jobpass directement dans leurs ATS et outils de gestion du recrutement.

Comment utiliser l'API recruteur Jobpass ? 

Pour utiliser l'API Recruteur, vous devez avoir créé votre espace recruteur sur Jobpass et souscrit notre offre API au préalable. Vous pouvez nous demander un accès de test afin de les paramétrer en cliquant ici.

Une fois votre espace recruteur créé sur Jobpass, 2 utilisations de l'API sont possibles : 

• Utilisation de l'API et de Jobpass Connect : Cette option vous correspondra si votre site carrière gère des comptes candidats (si les candidats doivent se créer un compte en renseignant un email et un mot de passe). Nous utilisons un protocole OpenID Connect permettant aux candidats de se créer un compte en 1 clic sur votre plateforme.
• Utilisation de l'API et du SDK Jobpass : cette option vous correspondra si votre site carrière ne gère pas de comptes candidats.

Une fois l'option choisie, il vous suffira de vous rendre dans votre espace d'administration sur Jobpass et de cliquer sur API dans le menu latéral. 

Configurer les clés API

Pour utiliser notre API, vous devez vous authentifier. Pour ce faire, vous devez générer des clés API sur votre espace. Ainsi, dans la page de configuration d'API, cliquez sur  Générer une clé puis entrez un nom pour vos clés et validez. Deux clés seront ensuite générées : 

• Une clé publique
• Une clé privée

Configurer une application OIDC - Jobpass Connect

Dans le cas où vous auriez choisi l'option Jobpass Connect pour utiliser l'API recruteur Jobpass, vous devez créer une application OIDC (OpenId Connect). Pour ce faire, descendez sur la page API, une fenêtre intitulée Identifiants d'application OpenId s'y trouve. 

Vous devez ainsi renseigner les champs suivants : 

• Nom de l'application
• Type d'application
  • Web : Application web traditionnelle utilisant des redirections. (exemple : Node.js Express, ASP.NET, Java, PHP)
  • Native : Applications mobiles, de bureau, CLI et pour appareils intelligents fonctionnant en mode natif. (exemple : iOS, Electron, Apple TV apps)
  • SPA : Une application frontend JavaScript qui utilise une API. (exemple : React, Vue, Angular)
  • Machine to Machine : CLIs, daemons ou services fonctionnant sur votre backend. (exemple : script shell)
• URIs de callback
• URI de callback de déconnexion
• Description (optionnelle)

Configurer les Webhooks Jobpass

Enfin, vous pouvez également configurer nos webhooks vous permettant de recevoir des événements dès qu'un candidat met à jour son profil. 

Pour ce faire, rentrez l'URL qui écoutera les webhooks dans vos systèmes et copiez la clé de sécurité qui s'affiche.