Intégration des nouvelles de MesVaccins.net et MedecineDesVoyages.net

Format des flux de nouvelles

Les nouvelles de MesVaccins.net peuvent être récupérées sous forme de flux d’actualités Atom. Il existe deux flux :

Chaque flux contient les 25 dernières nouvelles publiées au format Atom. Chaque nouvelle possède les attributs suivants :

  • Titre (title)
  • Auteur (author)
  • Identifiant unique (id)
  • Contenu (content)
  • Date de publication (published)
  • Date de dernière mise à jour (updated)
  • Lien vers la nouvelle sur mesvaccins.net (link)

Intégration des nouvelles dans la base de données d’un site tiers

Le site tiers doit périodiquement (toutes les heures ou plus fréquemment) récupérer le ou les flux de nouvelles qui l’intéresse(nt). Chaque flux doit être parsé à l’aide d’une librairie standard. Les opérations suivantes sont ensuite effectuées pour chaque nouvelle :

  • Si la nouvelle identifiée par le champ unique id est récupérée pour la première fois, créer l’enregistrement correspondant dans la table des nouvelles du site tiers.
  • Si la nouvelle a déjà été récupérée auparavant (reconnue grâce au champ id), et la date de modification dans le flux est différente de la date de modification de l’enregistrement dans la base de données du site tiers, mettre à jour tous les attributs de l’enregistrement en base de données avec les attributs de l’item dans le flux.
  • Si la nouvelle a déjà été récupérée auparavant (reconnue grâce au champ id), et la date de modification est la même dans le flux et en base de données, il n’y aucune opération à effectuer.

Les enregistrements correspondants aux nouvelles de MesVaccins.net doivent être marqués d’un tag spécifique.

Contraintes d’intégration des nouvelles sur les pages web du site tiers

Chaque page du site tiers intégrant une nouvelle de MesVaccins.net doit faire figurer :

  • Un lien vers la page de la nouvelle sur son site d’origine (MesVaccins.net ou MedecineDesVoyages.net), qui doit être clairement identifié ;
  • Dans la section ‘head’, une balise de lien canonique contenant l’URL de la nouvelle sur son site d’origine.

Filtrage des nouvelles

Pour le flux de médecine des voyages, il est possible de filtrer les nouvelles pas pays. Pour cela, il est nécessaire de passer le paramètre fips= dans la query string, avec en valeur le code FIPS du pays.

Métadonnées supplémentaires

Les métadonnées suivantes sont associées à chaque nouvelle de MesVaccins.net dont le format de représentation dans le flux Atom reste à déterminer :

  • Les vaccins associés à chaque nouvelle
  • Les maladies associées à chaque nouvelle
  • Les pays associées à chaque nouvelle
  • Un niveau d’alerte (normal, important, alerte)
  • Un flag signalant si la nouvelle correspond à une nouvelle recommandation vaccinale

Format des métadonnées

Les éléments sont enfants du tag entry, après le tag content. Voici le format de chacune des métadonnées.

Vaccins

<mesvaccins:vaccines>
    <mesvaccins:vaccine id="12">
        Boostrixtetra
    </mesvaccins:vaccine>
    ...
</mesvaccins:vaccines>

Maladies

<mesvaccins:diseases>
    <mesvaccins:disease id="4">
        Diphtérie
    </mesvaccins:disease>
    ...
</mesvaccins:diseases>

Pays

<mesvaccins:countries>
    <mesvaccins:country>
        Burkina Faso
    </mesvaccins:country>
    ...
</mesvaccins:countries>

Niveau d’alerte

<mesvaccins:alert_level>
    [[value]]
</mesvaccins:alert_level>

Où [[value]] prend une des valeurs suivantes : normal, important ou alert.

Public visé par la nouvelle

<mesvaccins:recipient_type>
    [[value]]
</mesvaccins:recipient_type>

Où [[value]] prend une des valeurs suivantes : public, professional ou all.

Flag de recommandation vaccinale

<mesvaccins:is_recommendation>
    [[value]]
</mesvaccins:is_recommendation>

Où [[value]] prend une des valeurs suivantes : true, false.