Récupération d'un flux d'offres d'emploi

Description

Récupère le flux XML des publications d'un jobboard.

---

Limites d'appels

Un flux ne peut être téléchargé qu'une fois toutes les 10 minutes pour une même combinaison de jobboardId, parentCompanyId et companyId.

---

Endpoint

GET https://api.mytalentplug.com/feeds/v1/jobs?jobboardId={jobboardId}&parentCompanyId={parentCompanyId}&companyId={companyId}

Authentification

• Requise : Oui
• Type : Bearer Authentication
• Exemple d'en-tête :

Authorization: Bearer <token>

---

Requête

Paramètres de query

Nom du paramètre	Type	Requis	Par défaut	Format	Exemple	Description
jobboardId	string	Oui	—	jb_...	jb_o7a4161	Identifiant du jobboard dont on récupère le flux
parentCompanyId	string	Non	—	co_...	co_123abcd	Identifiant de l'entreprise mère. Requis si companyId est fourni
companyId	string	Non	—	co_...	co_456efgh	Identifiant d'une filiale. Doit être accompagné de parentCompanyId

En-têtes de requête

En-tête	Requis	Exemple	Description
If-None-Match	Non	"33a64df551425fcc55e4d42a"	Valeur de l'ETag renvoyé lors d'un appel précédent. Si le flux n'a pas changé depuis, la réponse est un 304 Not Modified sans corps, afin d'éviter de retélécharger un flux inchangé

info

Le flux est toujours limité au jobboard désigné par jobboardId. Les paramètres parentCompanyId et companyId permettent de restreindre sa portée :

• aucun des deux : toutes les entreprises diffusant sur ce jobboard ;
• parentCompanyId : l'entreprise mère et ses filiales ;
• parentCompanyId et companyId : uniquement la filiale désignée par companyId.

---

Réponse

Réponse 200 (succès)

Le flux est renvoyé au format XML (application/xml) sous forme de flux d'octets. Chaque publication active est représentée par un élément. Le format exact (balises, encodage des champs) est propre à chaque jobboard et négocié individuellement ; l'exemple ci-dessous n'est qu'illustratif.

Exemple

<offres>
  <offre>
    <Reference>a1b2c3d4-e5f6-7890-abcd-1234567890ef</Reference>
    <ID>123456</ID>
    <title><![CDATA[Exemple d'intitulé de poste]]></title>
    <link><![CDATA[https://api.mytalentplug.com/job/v1/joboffer/redirect/?id=a1b2c3d4-e5f6-7890-abcd-1234567890ef]]></link>
    <description><![CDATA[Exemple de description du poste.]]></description>
    <salary periodicity="year" currency="EUR"><![CDATA[Exemple de rémunération]]></salary>
    <company><![CDATA[Exemple Entreprise]]></company>
    <contract_type><![CDATA[CDI]]></contract_type>
    <publication_date><![CDATA[2026-01-01]]></publication_date>
    <region1><![CDATA[Île-de-France]]></region1>
    <region2><![CDATA[75 - Paris]]></region2>
    <town><![CDATA[Paris]]></town>
    <postal_code><![CDATA[75000]]></postal_code>
    <country_name><![CDATA[France]]></country_name>
    <contract_length><![CDATA[Temps plein]]></contract_length>
    <expiration_date><![CDATA[2026-03-01]]></expiration_date>
  </offre>
</offres>

Exemple de headers

En-tête	Description
Content-Type	Type MIME du flux (application/xml)
Content-Disposition	Contient le nom du fichier (ex : attachment; filename="feed-jb_o7a4161-co_123abcd-co_456efgh.xml")
ETag	Empreinte du contenu, à réutiliser dans If-None-Match pour un téléchargement conditionnel

Réponse 304 (Not Modified)

Retournée lorsque l'en-tête If-None-Match de la requête correspond à l'ETag actuel du flux. Le flux n'a pas changé depuis le dernier téléchargement ; la réponse ne contient aucun corps.

Réponses d'erreur

Code HTTP	Message	Description
400	Bad Request	Identifiant (jobboardId, parentCompanyId ou companyId) mal formé
401	Unauthorized	Jeton d'accès manquant ou invalide
403	Forbidden	Accès refusé
404	Not Found	Jobboard introuvable
429	Too Many Requests	Limite d'appels dépassée (voir Limites d'appels)
500	Internal Server Error	Le serveur a rencontré un problème inattendu

---

Exemple de requête avec curl

curl -X GET 'https://api.mytalentplug.com/feeds/v1/jobs?jobboardId=jb_o7a4161&parentCompanyId=co_123abcd&companyId=co_456efgh' \
-H 'Authorization: Bearer <token>'