Dans cet article, vous allez découvrir comment communiquer avec Ernest en API :
- Récupération des offres d’Ernest dans votre site vitrine ;
- Envoi des candidatures à Ernest.
Préambule : remplacez votre-entreprise par le nom de votre entreprise dans les URLs ci-dessous.
Récupération des offres d’Ernest dans votre site vitrine
Ernest vous offre 2 possibilités pour récupérer les offres d’emploi.
Méthode 1 : Via iFrame (difficulté : ★☆☆)
L’iFrame est une balise HTML qui permet d’afficher une page web dans une autre page web. Ernest vous permet d’intégrer le site carrière au sein d’une de vos pages (balise HTML IFRAME). Vous pouvez activer plusieurs modes d’affichage pour une intégration optimale :
- Pour activer le mode iFrame du site carrière (masque le bouton Retour vers le site) : ?enable_integration ;
- Pour activer le mode iFrame du site carrière et masquer le header : ?enable_integration&disable_integration_header ;
- Pour activer le mode iFrame du site carrière et masquer le footer : ?enable_integration&disable_integration_footer ;
- Pour activer le mode iFrame du site carrière et masquer le header et le footer : ?enable_integration&disable_integration_footer&disable_integration_header.
Méthode 2 : Via endpoint JSON (difficulté : ★★☆)
Ernest vous permet de récupérer les offres d’emploi publiées sur le site carrière d’Ernest au format JSON. Pour cela, vous devez utiliser l’URL suivante : https://api-votre-entreprise.ernest.pattersonsoft.com/api/showcase/PARAM1 (méthode GET) avec l’en-tête HTTP X-AUTH-TOKEN ayant pour valeur public.
Le paramètre PARAM1 de l’URL correspond au nombre maximum d’offres à récupérer. Si aucun paramètre n’est passé, toutes les offres publiées sur le site carrière d’Ernest sont retournées.
L’API d’Ernest retourne un JSON contenant un tableau jobs avec les offres demandées. Pour chaque offre, les informations suivantes sont disponibles :
- uuid : Identifiant unique de l’offre – À utiliser pour envoyer une candidature via l’API d’Ernest (cf. section suivante) ;
- title : Titre de l’offre ;
- location : Ville de l’offre ;
- locationDetails : Détails sur le lieu de l’offre :
- zipCode : Code postal ;
- state : Département ;
- region : Region ;
- country : Pays ;
- entity : Entité de l’équipe RH qui gère cette offre ;
- contract : Type de contrat de l’offre ;
- salary : Salaire de l’offre ;
- description : Description de l’offre au format HTML;
- companyDescription : Description de l’entreprise au format HTML ;
- teamDescription : Description de l’équipe au format HTML ;
- profile : Profil recherché composé de plusieurs champs :
- level : Niveau d’étude recherché ;
- studies : Formation au format HTML ;
- skillsRequested : Liste des compétences requises au format HTML ;
- skillsBonus : Liste des compétences souhaitées au format HTML ;
- abilities : Liste des capacités et aptitudes au format HTML ;
- experience : Nombre d’expériences requis ;
- experienceDetails : Détails sur l’expérience requise ;
- publicationDate : Date de publication de l’offre ;
- businessSector : Secteur d’activité de l’offre ;
- link : Lien direct de l’offre sur le site carrière Ernest ;
- email : Adresse email d’envoi de candidatures pour l’offre.
La liste des offres retournées est classée par date de création décroissante.
Vous souhaitez une intégration plus forte avec votre site vitrine ? Aucun problème !
Contactez notre support afin que nous étudiions le meilleur moyen d’interconnecter votre site existant avec Ernest.
Envoi des candidatures à Ernest
Ernest vous offre 2 possibilités pour envoyer des candidatures.
Méthode 1 : Via email (difficulté : ★☆☆)
Vous pouvez récupérer l’adresse email d’envoi de candidatures (unique par offre) via l’API d’Ernest, dans le champ email de chaque offre. Vous pouvez ensuite envoyer un email à cette adresse avec le CV en pièce jointe et Ernest se charge de traiter la candidature.
Avec cette méthode, il n’est pas possible d’ajouter des informations supplémentaires à la candidature. Seules les pièces jointes sont prises en compte.
Méthode 2 : Via endpoint JSON (difficulté : ★★☆)
Ernest vous permet d’envoyer des candidatures directement via l’API. Pour cela, vous devez utiliser l’URL suivante : https://api-votre-entreprise.ernest.pattersonsoft.com/api/showcase-apply (méthode POST) avec l’en-tête HTTP X-Psoft-Authorization ayant pour valeur un jeton secret. Pour obtenir ce jeton secret, veuillez contacter notre support.
L’API d’Ernest attend un JSON contenant les informations suivantes :
- jobUuid : Identifiant unique de l’offre au format string – Cette donnée est disponible dans le JSON retourné par l’API d’Ernest, champ uuid – Champ à laisser vide pour les candidatures spontanées ;
- civility : Civilité du candidat au format string – Valeurs possibles : Monsieur, Madame, Mademoiselle – Champ non obligatoire ;
- lastname : Nom du candidat au format string – Champ obligatoire ;
- firstname : Prénom du candidat au format string – Champ obligatoire ;
- email : Adresse email du candidat au format string – Champ non obligatoire ;
- phone : Numéro de téléphone du candidat au format string – Champ non obligatoire ;
- linkedin : URL du profil LinkedIn du candidat au format string – Champ non obligatoire ;
- employed : Statut d’emploi du candidat au format boolean – Valeurs possibles : true, false – Champ non obligatoire ;
- experiencesDuration : Durée d’expérience du candidat au format integer – Champ non obligatoire ;
- jobContract : Type de contrat du poste actuel du candidat au format Duration ID – Valeurs possibles : voir référentiel de données – Champ non obligatoire ;
- level : Niveau d’étude du candidat au format Level ID – Valeurs possibles : voir référentiel de données – Champ non obligatoire ;
- availableAt : Date de disponibilité du candidat au format date DD/MM/YYYY – Champ non obligatoire ;
- jobSeekTitleNow : Titre du poste recherché par le candidat au format string – Champ non obligatoire ;
- jobSeekTitleNext : Titre du poste recherché par le candidat à l’avenir au format string – Champ non obligatoire ;
- jobSeekSalary : Salaire souhaité par le candidat au format integer – Champ non obligatoire ;
- jobSeekSalaryRaise : Augmentation de salaire souhaitée par le candidat au format integer – Champ non obligatoire ;
- jobSeekContracts : Types de contrats recherchés par le candidat au format array of Duration ID – Valeurs possibles : voir référentiel de données – Champ non obligatoire ;
- jobSeekAvailability : Disponibilité du candidat au format string – Champ non obligatoire ;
- jobSeekTripFrequencies : Fréquences de déplacements souhaitées par le candidat au format array of TripFrequency ID – Valeurs possibles : voir référentiel de données – Champ non obligatoire ;
- jobSeekDistance : Distance de déplacement maximum souhaitée par le candidat au format integer – Champ non obligatoire ;
- jobSeekOpenToMove : Mobilité géographique du candidat au format boolean – Valeurs possibles : true, false – Champ non obligatoire ;
- jobSeekDetails : Informations complémentaires sur la recherche d’emploi du candidat au format string – Champ non obligatoire ;
- address1 : Adresse du candidat au format Address – Champ non obligatoire ;
- jobSeekAddress1 : Localisation de travail souhaitée au format JobSeekAddress – Champ non obligatoire.
Pour récupérer les ID de niveaux d’étude (Level), de types de contrats (Duration) et de fréquences de déplacements (TripFrequency), vous pouvez obtenir le référentiel de données via l’URL suivante :
https://api-votre-entreprise.ernest.pattersonsoft.com/api/showcase-apply/sources(méthode GET) avec l’en-tête HTTP X-Psoft-Authorization ayant pour valeur un jeton secret. Pour obtenir ce jeton secret, veuillez contacter notre support.
Le format Address est un objet JSON contenant les informations suivantes :
- street : Rue de l’adresse au format string ;
- zipCode : Code postal de l’adresse au format string ;
- city : Ville de l’adresse au format string ;
- state : Département de l’adresse au format string ;
- region : Région de l’adresse au format string ;
- country : Pays de l’adresse au format string.
Le format JobSeekAddress est un objet JSON contenant les informations suivantes :
- jobSeekAddressStreet : Rue de l’adresse au format string ;
- jobSeekAddressZipCode : Code postal de l’adresse au format string ;
- jobSeekAddressCity : Ville de l’adresse au format string ;
- jobSeekAddressState : Département de l’adresse au format string ;
- jobSeekAddressRegion : Région de l’adresse au format string ;
- jobSeekAddressCountry : Pays de l’adresse au format string.
En plus des données du candidat, l’API d’Ernest peut recevoir 2 fichiers (format multipart) :
- cv : Fichier PDF du CV du candidat – Champ non obligatoire ;
- cover_letter : Fichier PDF de la lettre de motivation du candidat – Champ non obligatoire.
Dès réception de la candidature, Ernest va passer le CV dans notre IA Alfred afin d’en extraire les informations pertinentes et les ajouter au dossier du candidat.
