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’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