# L'API Joobs : vos offres d'emploi sur votre site, sans iframe

> Vos offres en JSON, affichées dans votre design, sur votre domaine. Les routes, la clé, les limites, et ce que ça change côté recrutement.

- **Author:** David Verbustel
- **Category:** ETFY8wgbX6Y616hUa4Fq
- **Published:** 2026-04-20
- **Language:** fr

La page carrière de beaucoup de PME belges affiche les offres de quelqu'un d'autre. Un cadre posé au milieu du site, avec ses propres polices, son propre défilement et son propre bouton de candidature. Techniquement, ça fonctionne. Le visiteur, lui, voit bien qu'il vient de changer de site sans avoir cliqué.
Il existe désormais une autre voie. L'API publique de Joobs vous rend vos offres sous forme de données, et vous les affichez vous-même : votre design, votre domaine, votre gabarit.
## Ce que l'iframe coûte vraiment
Une iframe est une page dans la page. Cette frontière a quatre conséquences, et aucune n'apparaît sur une facture — c'est précisément ce qui les rend faciles à ignorer.
- Le design s'arrête au cadre. Vos polices, vos couleurs et vos espacements ne franchissent pas la bordure. La zone la plus commerciale de votre site est la seule qui ne vous ressemble pas.

- Le mobile encaisse deux fois. Un cadre qui défile à l'intérieur d'une page qui défile : sur un téléphone, le visiteur perd le fil, ou perd le bouton.

- Le référencement part ailleurs. Le contenu d'une iframe n'appartient pas à votre domaine. Vos offres travaillent pour le référencement du site qui les sert, pas pour le vôtre.

- Vous ne mesurez rien. Votre outil d'analyse s'arrête à la bordure. Vous savez combien de personnes ont vu la page, pas combien ont lu une offre.


## Ce que fait l'API, en une phrase
Elle vous renvoie vos offres publiées sous forme de données, pour que votre site les affiche comme il affiche le reste.
Pas de widget à intégrer, pas de script tiers à charger dans le navigateur du visiteur. Une requête HTTP, du JSON en retour, et le rendu vous appartient entièrement.
curl -H "x-api-key: joobs_votre_cle" \
  https://europe-west1-leipzig-04103.cloudfunctions.net/api/v1/jobsLa réponse contient vos offres actives : titre, description, lieux, types de contrat, taille d'entreprise, et les intitulés de poste dans les quatre langues du site — français, anglais, néerlandais, allemand. Vous décidez de ce que vous affichez et de la façon dont vous l'affichez.
## Les quatre routes
RouteCe qu'elle renvoieCe que vous en faitesGET /v1/healthL'état du serviceVotre supervisionGET /v1/jobsVos offres publiques, paginéesLa liste sur votre page carrièreGET /v1/jobs/:idUne offre complèteLa page de détailPOST /v1/jobs/:id/applyL'accusé de dépôtVotre propre formulaire de candidatureLa liste se pagine avec limit et offset, cent offres au maximum par appel. Chaque offre porte aussi son adresse sur Joobs, si vous préférez y renvoyer plutôt que de construire vos propres pages de détail.
La route de candidature accepte un envoi multipart : nom, prénom, e-mail, message, et un CV au format PDF, DOC ou DOCX jusqu'à 10 Mo. Elle répond par un identifiant de candidature.
## La clé, et ce qu'elle ouvre
L'authentification tient dans un en-tête, x-api-key. La clé est rattachée à une seule organisation : elle ne donne accès qu'à vos offres, et aucune autre clé ne donne accès aux vôtres. Il n'y a pas d'identifiant d'organisation à passer dans la requête, donc pas moyen de se tromper de périmètre.
Joobs ne conserve jamais la clé en clair, seulement son empreinte. La révocation est immédiate : une clé désactivée renvoie une erreur dès l'appel suivant.
Le quota par défaut est de mille requêtes par jour. Chaque réponse vous renvoie ce qu'il vous reste, dans les en-têtes X-RateLimit-Limit et X-RateLimit-Remaining — de quoi surveiller la consommation sans compter vous-même.
La clé s'utilise depuis votre serveur, jamais depuis le navigateur. Une clé posée dans du JavaScript côté client est une clé publique : n'importe quel visiteur peut la lire dans les outils de développement. Passez par une route de votre propre site, qui appelle l'API et renvoie le résultat.
## Ce que l'API ne fait pas encore
Quatre limites valent d'être connues avant d'écrire la première ligne de code, parce qu'elles changent la façon dont vous construisez votre page.
- Le filtrage se fait chez vous. La liste accepte la pagination, pas de filtre par métier, par lieu ou par type de contrat. Vous récupérez vos offres et vous triez côté site — ce qui est de toute façon plus rapide quand vous en avez quelques dizaines.

- L'API lit, elle n'écrit pas les offres. Publier, modifier ou dépublier reste dans Joobs. La seule route qui écrit est celle des candidatures.

- Il n'y a pas encore de notification à la volée. Rien ne vient prévenir votre site qu'une offre a changé ; c'est vous qui appelez, à l'intervalle qui vous convient.

- Le candidat ne reçoit pas d'accusé de réception de Joobs. Le message de confirmation, c'est à votre formulaire de l'afficher. La notification part bien, mais vers vous, pas vers lui.


## Ce que ça change côté recrutement
Un développeur y voit une intégration. La personne qui recrute, elle, y gagne trois choses concrètes.
Vos offres travaillent enfin pour votre domaine. Des pages d'offres rendues par votre site sont des pages de votre site : elles s'indexent sous votre nom, elles alimentent votre référencement, et elles restent quand vous changez d'outil.
Le candidat ne change plus de site en cours de route. La rupture visuelle entre votre page carrière et le formulaire de candidature est un point de fuite classique. Elle disparaît quand tout est rendu par vous.
Les candidatures continuent d'arriver au même endroit. Une candidature déposée par l'API atterrit dans votre tableau de bord Joobs habituel, avec sa notification e-mail et son CV, exactement comme une candidature déposée sur Joobs. Elle porte juste une étiquette d'origine, pour que vous sachiez d'où elle vient.
Une intégration réussie ne se remarque pas. Le visiteur ne devrait jamais pouvoir deviner quel outil gère vos offres — ni en regardant la page, ni en postulant.
## Par où commencer
La documentation complète — authentification, référence des routes, schéma des données, limites — est disponible sur la page développeurs. Elle contient les exemples d'appel et le détail de chaque champ renvoyé.
L'accès à l'API fait partie du plan Premium. La clé se génère avec notre équipe, qui la rattache à votre organisation et fixe votre quota.
Faut-il un développeur pour intégrer l'API ?Oui, mais pas longtemps. Pour une page carrière classique — la liste des offres et une page de détail — comptez une demi-journée à la personne qui gère déjà votre site. L'API renvoie du JSON standard, sans dépendance particulière ni bibliothèque à installer.
Que se passe-t-il quand vous dépubliez une offre ?Elle disparaît de la réponse dès l'appel suivant. Si votre site met les résultats en cache — ce que nous recommandons, entre cinq et quinze minutes — l'offre reste visible le temps que le cache expire. C'est le seul décalage possible.
Où vont les candidatures déposées via l'API, et qui traite les données ?Dans votre tableau de bord Joobs, au même endroit que les autres. Le CV est stocké dans le même espace, la notification part vers la même adresse, et le compte candidat est créé — ou réutilisé si la personne a déjà postulé chez vous. Rien ne transite par un service tiers supplémentaire.
L'API est-elle incluse dans mon abonnement ?Elle fait partie du plan Premium, avec la synchronisation vers votre ATS et vers votre site. Si vous êtes sur un autre plan, parlez-en à notre équipe : la clé et le quota se mettent en place en même temps.

---
*Source: [Joobs.be](https://joobs.be/fr/blog/api-joobs-afficher-vos-offres-emploi-sur-votre-site)*