Si vous gérez déjà vos recrutements dans un logiciel, vous n’avez pas
à ressaisir vos offres chez nous. Notre API relie les deux : vos annonces
partent de votre outil, et les candidatures reçues y remontent
automatiquement.
Réservé aux comptes abonnés. L’API est incluse
dans les offres avec mise en avant. Sans abonnement, l’onglet reste visible dans votre
espace mais présente seulement ce qu’elle permet.
Ce que l’API fait pour vous
Publier sans ressaisie — l’offre créée dans votre logiciel
paraît sur le site, avec ses mises à jour et sa date d’expiration.
Récupérer les candidatures — chaque candidature, avec son CV et
les réponses aux questions de présélection, arrive dans votre outil.
Rester à jour dans les deux sens — une offre modifiée ou
désactivée chez vous l’est aussi en ligne.
Mettre en place la connexion
1
Depuis votre espace, ouvrez l’onglet API et intégrations, le dernier
du menu de gauche.
2
Demandez votre clé d’API à contact@jobsquare.ma,
en précisant le nom de votre société et le logiciel à connecter. Nous vous
l’envoyons par e-mail : elle n’est jamais affichée sur le site.
3
Transmettez la clé et l’adresse de la documentation
technique à la personne qui s’occupe de votre logiciel. Elle y trouvera des
exemples prêts à l’emploi en PHP, Node.js et Python.
4
Publiez une première offre de test depuis votre outil, puis vérifiez qu’elle
apparaît bien dans Offres d’emploi.
Votre clé vaut un mot de passe. Ne la diffusez pas
et ne la laissez pas dans un courriel qui circule. Si vous pensez qu’elle a été
vue par quelqu’un d’autre, demandez-nous de la remplacer : nous en créons
une nouvelle et l’ancienne cesse immédiatement de fonctionner.
Les informations transmises pour une offre
Votre logiciel envoie les mêmes informations que le formulaire du site : intitulé
du poste, secteur, type de contrat, description, exigences, ville, nombre de postes,
expérience, niveau d’étude, rémunération et mode de travail
(présentiel, hybride ou télétravail).
Pas de logiciel à connecter ? Une solution plus
simple existe : un flux XML de vos offres, que votre prestataire dépose et que nous
lisons régulièrement. Écrivez-nous, nous vous dirons ce qui convient le mieux
à votre organisation.
Si ça ne fonctionne pas
Vos offres ne partent plus — vérifiez d’abord que votre
abonnement est toujours actif. Sans abonnement, l’accès à l’API est suspendu.
Votre clé est conservée : elle refonctionne dès le renouvellement, sans
démarche de votre part.
Une erreur d’authentification — la clé utilisée n’est
plus la bonne. Contactez-nous, nous vérifions celle qui est active sur votre compte.
Une offre part mais s’affiche mal — c’est en général une
correspondance à ajuster entre les valeurs de votre logiciel et les nôtres
(secteur, type de contrat, ville). La documentation explique comment les récupérer.