Nomenclature des vaccins

MesVaccins.net utilise sa propre nomenclature pour la structuration et l’identification des vaccins, en l’absence de norme internationale d’identification des vaccins.

Les codes CIP et UCD (voir codifications UCD et CIP) sont des codes d’identification nationaux, qui ne prennent pas en compte les spécialités ne possédant pas d’autorisation de mise sur le marché en France. Ils sont fournis pour faciliter l’intégration avec les systèmes existants.

Récupération de la liste des vaccins

  • GET /vaccines.json retourne la liste des vaccins

Le résultat est sous ce format :

[
  {
    "id": 175,
    "name": "A.D.T.",
    "marketing_start": null,
    "marketing_end": null,
    "french": false,
    "alternative_names": [
      "ADT",
      "A.D.T."
    ],
    "ucd_code": null,
    "cip_codes": [],
    "diseases": [
      {
        "id": 1,
        "name": "Dipht\u00e9rie"
      },
      {
        "id": 2,
        "name": "T\u00e9tanos"
      }
    ],
    "valences": [
      {"id": 2},
      {"id": 3}
    ]
  },
  "..."
]
Attribut Description
id Identifiant du vaccin dans la nomenclature MesVaccins.net
name Nom commercial du vaccin
marketing_start Date de début de commercialisation du vaccin en France
marketing_end Date de fin de commercialisation du vaccin en France
french Vaccin commercialisé en France
alternative_names Autres noms usuels du vaccin
ucd_code Code UCD du vaccin (si existant)
cip_codes Codes CIP du vaccin (si existants)
diseases Liste des maladies contre lesquelles protège le vaccin
valences Liste des id des valences du vaccin

Recherche d’un vaccin

Ce service permet de développer une fonctionnalité d’auto-complétion dans un formulaire de saisie de vaccin :

Exemple d'autocomplétion dans l'interface de saisie de vaccination de MesVaccins.net
Exemple d’auto-complétion dans l'interface de saisie de vaccination de MesVaccins.net
  • GET /vaccines/search.json?name=DTP retourne la liste des vaccins dont le nom contient "DTP" ou qui protègent contre le groupe de maladies "DTP"

Le résultat est au format suivant :

[
  {
    "id": 177,
    "name": "AC VAX",
    "short_description": "...",
    "ucd_code": null,
    "cip_codes": [],
    "marketing_start": null,
    "marketing_end": null,
    "french": false,
    "alternative_names": ["ACVAX"],
    "diseases": [{"id": 49, "name": "Méningocoques A-C"}]
  }, {
      "id": 1,
      "name": "ACT-HIB",
      "short_description": "...",
      "ucd_code": null,
      "cip_codes": [],
      "marketing_start": "1992-02-06",
      "marketing_end": null,
      "french": true,
      "alternative_names": ["ACTHIB", "HIB", "HAEMOPHILUS", "influenzae", "haemophilusinfluenzaetypeb", "haemophilusinfluenzaeb", "hemophilusInfluenzaeTypeb", "hemophilusInfluenzaeb"],
      "diseases": [{"id": 5, "name": "Haemophilus influenzae b"}]
  },
  "..."
]

Les paramètres sont les suivants :

Paramètre Description
name (ou query) Extrait du nom du vaccin
cip_code Extrait du code CIP du vaccin
date
Format : YYYY-MM-DD
Filtre les vaccins en pour ne retourner que ceux commercialisés à cette date
include_foreigns
Format : 0 ou 1
Si égal à 1, les vaccins non commercialisés dans le pays sont inclus dans la réponse