Analyse des effets indésirables

Introduction

La requête getAdverseEffects permet de récupérer les effets indésirables liées à un médicament clinique (aka médicament virtuel), une spécialité (CIS), une unité commune de dispensation (UCD7 ou UCD13) ou une présentation (CIP7 ou CIP13)

Point d’entrée

post/aort/v1/graphql

En-têtes HTTP

Nom	Valeur
`Content-Type`	`application/json`
`Authorization`	`Bearer <token>`

Variables

Pour saisir les médicaments, utiliser l’autocomplete avec entity_type=DRUG.
Pour saisir les effets indésirables, utiliser l’autocomplete avec entity_type=ADVERSE_EFFECT.

Variable	Type	Description
`drugs`	`DrugInput[]`	Liste des medicaments à analyser
`adverseEffectsToAvoid`	`CodingInputWithLabel[]`	Paramètres biologiques du patient
`incidence`	`Incidence[]`	Fréquence de survenue de l’effet indésirable
`snomedInferrence`	`Boolean`	Paramètre permettant de chercher les effets indésirables sur les conditions proches via des inférences permises par la SNOMED.

Résultat

L’API renvoie un objet de type AdverseEffectResult.

AdverseEffectResult

Attributs	Type	Description
`drug`	`Drug[]`	Médicaments potentiellement responsables de l’effet indésirable
`AdverseEffects`	`AdverseEffect[]`	Liste des effets indésirables

Drug

Attributs	Type	Description
`clinicalDrug`	`CodingWithInn`	Code désignant un médicament clinique
`brandedDrug`	`CodingWithInn`	Code désignant une spécialité
`packagedDrug`	`CodingWithInn`	Code désignant un médicament

Coding

Attributs	Type	Description
`code`	`string`	Code de cette entité dans la terminologie
`label`	`string`	Label de cette entité dans la terminologie
`terminology`	`string`	Identifiant de la terminologie, valable à travers la base

CodingWithInn

Attributs	Type	Description
`code`	`string`	Code de cette entité dans la terminologie
`label`	`string`	Label de cette entité dans la terminologie
`terminology`	`string`	Identifiant de la terminologie, valable à travers la base
`inn`	`string`	Code de l’identifiant INN

AdverseEffect

Attributs	Type	Description
`behaviour`	`string`	Conduite à tenir en cas de survenue de l’effet indésirable
`dosage`	`string`	Dose de médicament propice à la survenue de l’effet indésirable
`incidence`	`string`	Fréquence de survenue de l’effet indésirable
`phase`	`String`	Phase du traitement propice à la survenue de l’effet indésirable

Source

Attributs	Type	Description
`url`	`string`	URL consultable pour cette source
`author`	`String`	Auteur responsable de cette source

Condition

Les conditions médicales englobent l’ensemble des situations ou d’états de santé spécifiques d’un individu, qu’il s’agisse de pathologies, de terrains médicaux particuliers (tels que la grossesse ou l’immunodéficience), ou encore de symptômes, effets indésirables liés à la prise d’un traitement médicamenteux

Attributs	Type	Description
`designation`	`String`	Nom de la condition médicale
`associatedConditions`	`AssociatedCondition[]`	Condition associée concomittante ou précisant la condition principale. Les conditions associées ont une designation et peuvent être reliées à un ou plusieurs modifiers, ainsi qu’avoir un ou plusieurs codings.
`modifiers`	`String[]`	Objet précisant la sévérité, l’état, l’intensité, la chronologie ou la localisation d’une condition. Cet objet est un Enum.
`codings`	`Coding[]`	Codes précisant les conditions médicales. Les terminologies disponibles sont la SNOMED, la CIM10 et Meddra. Pour les affections de longues durée des codes spécifiques sont inclus dans cette liste.

Patient

Objet précisant les critères patient, il permet de préciser les conditions d’utilisation d’un traitement pour une indication dans une population particulière, ou de préciser chez quelle population un traitement est contre-indiqué ou encore chez quelle population survient un effet indésirable.

Attributs	Type	Description
`gender`	`String`	Sexe biologie du patient. Cet objet est un Enum avec comme valeur possible Homme ou Femme
`ageGroups`	`String[]`	Catégorie d’âge concernée. Les différentes valeurs possibles sont : Prématuré, Nouveau-né (0 à 1 mois), Nourrisson (1 à 24 mois), Enfant (0 mois à 18 ans), Adolescent (12 à 18 ans), Adulte (> 17 ans) et Senior (> 64 ans).
`concurrentTreatments`	`Treatment[]`	Traitements pris par le patient.
`continuousCriteria`	`ContinuousCriterion[]`	Mesure décrivant l’état du patient.

Treatment

Objet permettant de préciser différents traitements pris ou à prendre par un patient.

Attributs	Type	Description
`ingredients`	`String[]`	Substance rattachée à l’objet Treatment. Le format de cet objet est décrit dans Ingredient.
`procedures`	`String[]`	Procédure rattachée à l’objet Treatment. Cet objet a la forme d’un Coding dont la terminologie est Meddra.
`therapeuticClasses`	`String[]`	Classes thérapeutiques rattachées à l’objet Treatment. Cet objet a la forme d’un Coding dont la terminologie est l’ATC.

Continuous Criterion

Un critère continu désigne une mesure ou une variable qui peut prendre une infinité de valeurs dans un intervalle donné. Les critères continus sont souvent utilisés pour décrire des caractéristiques quantitatives, comme la taille, le poids, la clairance de la créatinine, etc.

Attributs	Type	Description
`type`	`String`	Type de paramètre biologique
`unit`	`String`	Unité du paramètre biologique
`min`	`Float`	Borne inférieure du paramètre biologique
`max`	`Float`	Borne supérieure du paramètre biologique

Exemple

Effets-indésirables

query getAdverseEffects($drugs: [DrugInput!]!, $adverseEffectsToAvoid: [CodingInputWithLabel!], $incidence: [Incidence!], $snomedInferrence: Boolean) {
  getAdverseEffects(drugs: $drugs, adverseEffectsToAvoid: $adverseEffectsToAvoid, incidence: $incidence, snomedInferrence: $snomedInferrence) {
    drug {
      clinicalDrug {
        code
        inn
        label
        terminology
      }
      brandedDrug {
        code
        inn
        label
        terminology
      }
      packagedDrug {
        code
        inn
        label
        terminology
      }
    }
    adverseEffects {
      condition {
        designation
        codings {
          label
          code
          terminology
        }
        modifiers
        associatedConditions {
          designation
          modifiers
          codings {
            label
            code
            terminology
          }
        }
      }
      incidence
      patient {
        gender
        ageGroups
        continuousCriteria {
          type
          unit
          min
          max
        }
        concurrentTreatments {
          ingredients
          procedures
          therapeuticClasses
        }
      }
      dosage
      phase
      behaviour
    }
  }
}

Contre-indications-variables

{
  "drugs": [
    {
      "brandedDrug": {
        "code": "67682298",
        "terminology": "cis"
      }
    },
    {
      "brandedDrug": {
        "code": "63485353",
        "terminology": "cis"
      }
    }
  ],
  "adverseEffectsToAvoid": [
    {
      "code": "165517008",
      "terminology": "snomed"
    }
  ],
  "snomedInferrence": true
}

Réponse

{
  "data": {
    "getAdverseEffects": [
      {
        "drug": {
          "clinicalDrug": null,
          "brandedDrug": {
            "code": "67682298",
            "inn": "isotrétinoïne",
            "label": "PROCUTA 40 mg, capsule molle",
            "terminology": "cis"
          },
          "packagedDrug": null
        },
        "adverseEffects": [
          {
            "condition": {
              "designation": "neutropénie",
              "codings": [
                {
                  "label": "neutropénie",
                  "code": "165517008",
                  "terminology": "snomed"
                },
                {
                  "label": "Neutropénie",
                  "code": "10029354",
                  "terminology": "meddra"
                },
                {
                  "label": "Agranulocytose",
                  "code": "D70",
                  "terminology": "cim10"
                }
              ],
              "modifiers": [],
              "associatedConditions": []
            },
            "incidence": "Fréquent (≥1/100, <1/10)",
            "patient": {
              "gender": null,
              "ageGroups": [],
              "continuousCriteria": [],
              "concurrentTreatments": {
                "ingredients": [],
                "procedures": [],
                "therapeuticClasses": []
              }
            },
            "dosage": null,
            "phase": null,
            "behaviour": null
          }
        ]
      },
      {
        "drug": {
          "clinicalDrug": null,
          "brandedDrug": {
            "code": "63485353",
            "inn": "imatinib",
            "label": "GLIVEC 400 mg, comprimé pelliculé",
            "terminology": "cis"
          },
          "packagedDrug": null
        },
        "adverseEffects": [
          {
            "condition": {
              "designation": "neutropénie",
              "codings": [
                {
                  "label": "neutropénie",
                  "code": "165517008",
                  "terminology": "snomed"
                },
                {
                  "label": "Neutropénie",
                  "code": "10029354",
                  "terminology": "meddra"
                },
                {
                  "label": "Agranulocytose",
                  "code": "D70",
                  "terminology": "cim10"
                }
              ],
              "modifiers": [],
              "associatedConditions": []
            },
            "incidence": "Très fréquent (≥1/10)",
            "patient": {
              "gender": null,
              "ageGroups": [],
              "continuousCriteria": [],
              "concurrentTreatments": {
                "ingredients": [],
                "procedures": [],
                "therapeuticClasses": []
              }
            },
            "dosage": null,
            "phase": null,
            "behaviour": null
          },
          {
            "condition": {
              "designation": "neutropénie fébrile",
              "codings": [
                {
                  "label": "Neutropénie fébrile",
                  "code": "10016288",
                  "terminology": "meddra"
                },
                {
                  "label": "neutropénie fébrile",
                  "code": "409089005",
                  "terminology": "snomed"
                },
                {
                  "label": "Agranulocytose",
                  "code": "D70",
                  "terminology": "cim10"
                }
              ],
              "modifiers": [],
              "associatedConditions": []
            },
            "incidence": "Fréquent (≥1/100, <1/10)",
            "patient": {
              "gender": null,
              "ageGroups": [],
              "continuousCriteria": [],
              "concurrentTreatments": {
                "ingredients": [],
                "procedures": [],
                "therapeuticClasses": []
              }
            },
            "dosage": null,
            "phase": null,
            "behaviour": null
          }
        ]
      }
    ]
  }
}

Codes de réponse

Code	Description
`200`	OK
`400`	Un des paramètres passés dans la requête est invalide

Alertes de posologie Modèle FHIR de la prescription