Fiches et provenance

#L’objet Record

country string

Code pays à deux lettres de la source.

sourceId string

La source dont provient la fiche, par exemple it.aifa.packages.

id string

L’identité de la fiche au sein de sa source. Stable d’une collecte à l’autre.

kind string

Le type de fiche au sein de la source, comme packages, ingredients ou veterinary-medicines.

name string

Le nom d’affichage de la fiche : son premier nom.

names string[]

Tous les noms sous lesquels la fiche peut être trouvée, issus de ses propres champs.

identifiers object[]

Identifiants typés sous la forme { scheme, value }, comme aic, cn, ndc-package ou din. Les valeurs sont toujours des chaînes de caractères.

data object

Les champs normalisés de la source, ainsi que useDomain et targetSpecies avec leurs justificatifs.

region string | null

Une région infranationale lorsque la source est régionale, sinon null.

retrievedAt string

Date et heure ISO 8601 auxquelles la fiche a été collectée auprès de sa source.

sourceUrl string

Le jeu de données officiel dont provient la fiche.

licence object

La licence de la source : id, url et texte d’attribution à afficher.

limitations string[]

Ce que la source n’établit pas, comme la commercialisation actuelle ou l’éligibilité d’un patient.

#Les sources restent indépendantes

Plusieurs sources peuvent décrire le même médicament. Medifontis ne fusionne jamais les fiches et ne les relie jamais par leur nom ; reliez-les vous-même au moyen d’identifiants, comme un code ATC ou un code national, lorsque les sources les publient.

#Identifiants

Les identifiants sont typés : le schéma indique ce que représente la valeur, et les valeurs sont toujours des chaînes de caractères, ce qui préserve les zéros initiaux. Chaque source publie ses propres schémas ; le guide de recherche liste ceux de ce pays.

#Provenance

• sourceUrl renvoie au jeu de données officiel dont provient la fiche.
• retrievedAt indique quand Medifontis l’a collectée.
• licence indique les conditions de l’éditeur et l’attribution à afficher.
• limitations liste ce que la source n’établit pas, comme la disponibilité actuelle.

#Ce qu’une fiche ne vous dit pas

#Récupérer à nouveau une fiche

Pour actualiser une fiche que vous avez enregistrée, lisez-la à partir de son pays, de son sourceId et de son id avec GET /v1/drugs/record. L’endpoint répond 404 lorsque la source ne publie plus la fiche.

curl -G https://api.medifontis.com/v1/drugs/record \
  -H "Authorization: Bearer $MEDIFONTIS_API_KEY" \
  --data-urlencode "country=ca" \
  --data-urlencode "sourceId=ca.health-canada.dpd" \
  --data-urlencode "id=ca:health-canada:products:62265"

const params = new URLSearchParams({ country: 'ca', sourceId: 'ca.health-canada.dpd', id: 'ca:health-canada:products:62265' })
const response = await fetch(`https://api.medifontis.com/v1/drugs/record?${params}`, {
  headers: { Authorization: `Bearer ${process.env.MEDIFONTIS_API_KEY}` },
})
if (!response.ok) throw new Error(`Medifontis ${response.status}`)
const { record } = await response.json()

import os

import requests

response = requests.get(
    "https://api.medifontis.com/v1/drugs/record",
    params={"country": "ca", "sourceId": "ca.health-canada.dpd", "id": "ca:health-canada:products:62265"},
    headers={"Authorization": f"Bearer {os.environ['MEDIFONTIS_API_KEY']}"},
    timeout=10,
)
response.raise_for_status()
record = response.json()["record"]