Création d'un flux XML

Pour importer vos missions, vous devez mettre à disposition un flux XML. L'API actualise sa base de données de manière autonome en analysant le flux XML toutes les 3 heures.

Cette partie de la documentation est à destination de votre responsable informatique : elle présente les critères nécessaires pour créer votre flux XML, c’est à dire l’envoi d’informations vers l’API Engagement.

Introduction

Les partenaires annonceurs doivent mettre à disposition un flux XML qui sera récupéré toutes les 3 heures par l’API Engagement afin de mettre à jour les missions qu’elle a en base de données.

Ce flux est accessible via un lien public qui renvoie un fichier XML. Pour télécharger ce flux, le processus est le suivant:

 const xml = await fetch("<https://www.partenaire.fr/mes-missions.xml>", { headers }).then((response) => response.text());

Si cette commande ne permet pas d'avoir vos missions, alors le lien fourni est mal configuré.

Détails du fichier XML

L'architecture du fichier XML est la suivante:

<?xml version="1.0" encoding="UTF-8"?>
<source>
   <publisher>Example Job Site</publisher>
   <publisherurl><http://www.examplemissionsite.com></publisherurl>
   <lastBuildDate>Fri, 10 March 2020 22:49:39 GMT</lastBuildDate>
   <mission>
      <title><![CDATA[Sales Executive]]></title>
      <clientId><![CDATA[32132143]]></clientId>
			{...}
      <organizationFullAddress><![CDATA[55 Rue du Faubourg Saint-Honoré 75008 Paris]]></organizationFullAddress>
   </mission>
    [...]
</source>
  • Le flux doit contenir toutes les missions disponibles :

    • Chaque mission présente dans le flux qui n’est pas dans la base de données de l’API est ajoutée dans la base de données

    • Chaque mission présente dans le flux qui est dans la base de données de l’API est mise à jour.

    • Chaque mission absente du flux qui est dans la base de données de l’API est retirée de la base de données.

  • Les missions doivent suivre le modèle de données

  • L’intégralité du contenu des missions doit être à l'intérieur d'une balise CDATA.

  • Le flux doit comprendre un codage de caractères approprié dans l'en-tête XML. L'exemple ci-dessus illustre l'encodage UTF-8, mais cela peut ou non être le cas pour vous :

<?xml version="1.0" encoding="UTF-8"?>
<source>
   <publisher>Example Job Site</publisher>
   <publisherurl><http://www.examplemissionsite.com></publisherurl>
   <lastBuildDate>Fri, 10 March 2020 22:49:39 GMT</lastBuildDate>
   <mission>
      <title><![CDATA[Sales Executive]]></title>
      <clientId><![CDATA[32132143]]></clientId>
      <description><![CDATA[Do you have 1-3 years of (...) sign up !]]></description>
      <applicationUrl><![CDATA[www.urltomymission.org]]></applicationUrl>
      <postedAt><![CDATA[Fri, 10 Dec 2005 22:49:39 GMT]]></postedAt>
      <startAt><![CDATA[Fri, 10 Dec 2005 22:49:39 GMT]]></startAt>
      <endAt><![CDATA[Fri, 20 Dec 2005 22:49:39 GMT]]></endAt>
      <address><![CDATA[1 rue les trois cornieres]]></address>
      <postalCode><![CDATA[56430]]></postalCode>
      <city><![CDATA[Mauron]]></city>
      <country><![CDATA[FR]]></country>
      <places><![CDATA[2]]></places>
      <activity><![CDATA[logistique]]></activity>
      <remote><![CDATA[full]]></remote>
      <domain><![CDATA[environnement]]></domain>
      <tags><![CDATA[environnement,écologie]]></tags>
      <image><![CDATA[<https://monurl.com/1.jpg>]]></image>  
      <organizationName><![CDATA[Big ABC Corporation]]></organizationName>
      <organizationRNA><![CDATA[W922000733]]></organizationRNA>
      <organizationSiren><![CDATA[332737394]]></organizationSiren>
      <organizationUrl><![CDATA[www.organizationname.com]]></organizationUrl>
      <organizationId><![CDATA[123312321]]></organizationId>
      <organizationType><![CDATA[1901]]></organizationType>
      <organizationFullAddress><![CDATA[55 Rue du Faubourg Saint-Honoré 75008 Paris]]></organizationFullAddress>
      <organizationStatusJuridique><![CDATA[Association]]></organizationStatusJuridique>
   </mission>
    [...]
</source>

Conditions d'utilisation

Votre flux sera désactivé et vos offres de missions seront supprimées de nos résultats de recherche sans préavis si vous ne respectez pas les conditions suivantes:

  • L'URL que vous fournissez doit être un lien ouvert au public de manière permanente

  • Vous ne devez pas exiger de l'utilisateur qu'il se connecte pour afficher la description des missions

  • Toutes les missions fournies dans votre flux XML doivent être uniques à votre site web

  • Vous ne devez pas inclure les emplois d'autres plateformes dans votre flux XML

  • Vous ne devez pas inclure des missions expirées ou fermées dans votre flux XML

Last updated