Widget : tester et consulter la documentation

Sur cette page, vous trouverez la documentation pour intégrer le widget LBA sur votre site, permettant de requêter et afficher les formations et les entreprises pour entrer en alternance.

Tester le widget de recherche Labonnealternance

Pour voir comment le widget peut s'intégrer sur votre site, testez dès à présent les différentes versions possibles : https://labonnealternance.apprentissage.beta.gouv.fr/test-widget

Notice d’intégration du widget Labonnealternance

Vous devez intégrer Labonnealternance dans une Iframe : <iframe src="https://labonnealternance.apprentissage.beta.gouv.fr/chemin?parametres" />
Ex de valeur pour le paramètre src : https://labonnealternance.apprentissage.beta.gouv.fr/recherche-apprentissage?radius=60&romes=F1702,F1705,F1701&scope=all&lat=47&lon=2.2&caller=contact%40mail.com%20ID_service_appelant_labonnealternance&return_uri=/&return_logo_url=https://url/image.png
A / Chemins :
/recherche-apprentissage : pour rechercher en même temps des formations en apprentissage et des emplois en alternance
/recherche-emploi : pour rechercher uniquement des emplois en alternance
/recherche-apprentissage-formation : pour rechercher uniquement des formations

B / Liste des paramètres :

radius : Optionnel . Valeur numérique. Valeurs autorisées : 10 | 30 | 60 | 100. Le rayon de recherche autour du lieu en km. Valeur par défaut 30.
romes : Optionnel. Une liste de codes romes séparés par des virgules. Ex : A1021 | F1065,F1066,F1067 . Maximum 3 romes. Valeur par défaut null.
lat : Optionnel. Coordonnée géographique en degrés décimaux (float). Valeur par défaut null. La partie lattitude des coordonnées gps.
lon : Optionnel. Coordonnée géographique en degrés décimaux (float). Valeur par défaut null. La partie longitude des coordonnées gps.
caller : Obligatoire. L'identification du site appelant. A fixer lors de la mise en place avec l’équipe de Labonnealternance. Idéalement de la forme "[email protected] id_organisme_appelant" afin de nous permettre de vous contacter en cas d'annonce importante relative au fonctionnement de l'API
return_uri : Optionnel. Valeur par défaut / . L'uri de retour qui sera notifiée au site appelant. ****
return_logo_url : Optionnel. Valeur par défaut : logo du site Labonnealternance.pole-emploi.fr . L'url du logo du site vers lequel l'utilisateur revient en cliquant sur le bouton de retour dans Labonnealternance. ****
scope : déprécié. Ce paramètre n'est plus utilisé.
frozen_job : si ce paramètre est renseigné alors il n'est pas possible de modifier le métier sur le formulaire de recherche.
job_name : un nom pour le métier recherché.
Si caller, lat, lon et romes sont correctement renseignés une recherche sera lancée automatiquement en utilisant ces critères. Si radius est correctement renseigné il sera utilisé comme critère de la recherche.

Si romes, frozen_job et job_name sont renseignés le formulaire de recherche ne permettra pas de modifier le métier et rappellera le nom dudit métier.

****

C / Bouton de retour

Cliquer sur le logo en haut du formulaire ou d’une liste de résultat permet de signaler à la page appelante une instruction de changement de page.
Si vous ne codez rien cette fonctionnalité n’a pas d’effet.
Pour bénéficier du bouton de retour vous devez ajouter un listener pour l'API postMessage de javascript et coder l’action de navigation :
window.addEventListener('message',function(e){
/*Remplacer par votre code pour gérer la navigation vers la page de votre site correspondante aux paramètres transmis par Labonnealternance dans le message*/
console.log("Type du message goToPage ", e.data.type);
console.log("URI de la page de redirection ", e.data.page);
});

Tester le widget de candidature Labonnealternance

Notice d’intégration du widget Labonnealternance

Vous devez intégrer ce widget dans une Iframe : <iframe src="https://labonnealternance.apprentissage.beta.gouv.fr/postuler?caller=site_exposant_le_widget&itemId=identifiant_societe_ou_offre&type=lba|lbb|matcha" />
Les paramètres d'appel caller, itemId et type sont obligatoires :
caller : Un identifiant de votre choix pour nous signaler qui vous êtes.
itemId : l'identifiant de l'offre pour postuler à une offre publiée via La bonne alternance recruteur ou l'identifiant de la société (SIRET) pour une candidature spontanée vers une société identifiée comme susceptible de recruter en alternance.
type : le type de candidature. lba ou lbb pour une candidature spontanée. matcha pour une offre publiée sur La bonne alternance recruteur.
A noter qu'itemId et type doivent être cohérents et correspondre à des sociétés/offres pour lesquelles nous disposons des informations nécessaires pour postuler.
Vous pouvez récupérer ces informations en utilisant les apis de la La bonne alternance.
Les sociétés compatibles avec le widget pour postuler sont celles comportant le fragment JSON suivant renseigné :
"contact": { "email": "----", "iv": "----" }
Le type peut être trouvé grâce à l'attribut ideaType du JSON.
L'itemId (SIRET) pour les lba et lbb se trouve ici : "company": { "siret": itemId...
L'itemId pour les matcha se trouve ici : "job": { "id": itemId...
NOTE : pour postuler aux offres de Pôe emploi il faut passer par leur site.