APIs
Référence API
Analyse
Interactions

Analyse d'interactions

La requête getInteractions permet de récupérer les contre-indications liées à un médicament clinique (aka médicament virtuel) ou un ingrédient.

Point d'entrée

post/aort/v1/graphql

En-têtes HTTP

NomValeur
Content-Typeapplication/json
AuthorizationBearer <token>

Variables

VariableInput fieldTypeDescription
drugsclinicalDrugsString[]Liste des identifiants(ex: "MV00003202") de médicament cliniques à analyser
drugsingredientsIngredientInputListe des ingredients à analyser
typesString[]Type et niveau d'alerte

IngredientsInput

Liste des ingredients à analyser, décrit soit par leur code snomed, leur code inn ou la designation sous forme de chaîne de caractères.

FieldTypeDescription
codesString[]Liste des codes
designationsString[]Liste des désignations

Résultat

L'API renvoie un objet de type AlertResult.

AlertResult

AttributsTypeDescription
designationStringLa designation de l'interaction. La designation contient les deux groupes déclencheurs séparés par <>
typeStringType de l'interaction (Précaution d'emploi, Contre-Indication, Association DECONSEILLEE, ...)
conditionStringToujours null pour les interactions
patientStringToujours null pour les interactions
warnings[Warning]Liste des mises en gardes
drugsDrugEnsemble des médicaments responsables de l'interaction
commentStringToujours null pour les interactions
sourceSourceSource de l'interaction

Drug

AttributsTypeDescription
specialities[Code]Liste de codes désignant une spécialité
clinicalDrugs[ClinicalDrugCode]Liste de codes désignant un médicament cliniques
ingredients[String]Liste de désignation des ingrédients
brandnames[String]Liste des noms de marques des médicaments

Code

AttributsTypeDescription
codestringCode de cette entité dans la terminologie
labelstringLabel de cette entité dans la terminologie
terminologystringIdentifiant de la terminologie

ClinicalDrugCode

AttributsTypeDescription
codestringCode de cette entité dans la terminologie
labelstringLabel de cette entité dans la terminologie
terminologystringIdentifiant de la terminologie, valable à travers la base
innStringDénomination commune internationale du médicament

Warning

AttributsTypeDescription
riskStringRisque de l'interaction
guidelinesString[]Conduite à tenir

Source

AttributsTypeDescription
urlstringURL consultable pour cette source
authorStringAuteur responsable de cette source

Exemple

Interactions

query getInteractions($drugs: DrugInput) {
  getInteractions(drugs: $drugs) {
    designation
    source {
      author
      url
    }
    drugs {
      clinicalDrugs {
        code
        inn
        label
      }
    }
    condition {
      designation
      modifiers
      associatedConditions {
        designation
        modifiers
      }
    }
    type
    patient {
      ageGroup
      gender
      continuousCriteria {
        max
        min
        type
        unit
      }
      concurrentTreatments {
        ingredients
        procedure
        therapeuticClass
      }
    }
    warnings {
      risk
      guidelines
      modifiers
    }
  }
}

Réponse

{
  "data": {
    "getInteractions": [
      {
        "designation": "potassium <> inhibiteurs de l'enzyme de conversion",
        "source": {
          "author": "Thesaurus - ANSM",
          "url": "https://ansm.sante.fr/uploads/2020/10/27/20201027-thesaurus-referentiel-national-des-interactions-medicamenteuses-20102020.pdf"
        },
        "drugs": {
          "clinicalDrugs": [
            {
              "code": "MV00001780",
              "inn": "potassium (chlorure de)",
              "label": "DIFFU-K 600 mg, gélule"
            },
            {
              "code": "MV00000353",
              "inn": "ramipril",
              "label": "RAMIPRIL KRKA 1,25 mg, comprimé"
            }
          ]
        },
        "condition": null,
        "type": "Association DECONSEILLEE",
        "patient": null,
        "warnings": [
          {
            "risk": "Pour une quantité de potassium > à 1 mmol/prise, hyperkaliémie potentiellement létale, notamment chez l'insuffisant rénal (addition des effets hyperkaliémiants).",
            "guidelines": ["Sauf s'il existe une hypokaliémie."],
            "modifiers": []
          }
        ]
      },
      {
        "designation": "hyponatrémiants <> autres médicaments hyponatrémiants",
        "source": {
          "author": "Thesaurus - ANSM",
          "url": "https://ansm.sante.fr/uploads/2020/10/27/20201027-thesaurus-referentiel-national-des-interactions-medicamenteuses-20102020.pdf"
        },
        "drugs": {
          "clinicalDrugs": [
            {
              "code": "MV00001780",
              "inn": "potassium (chlorure de)",
              "label": "DIFFU-K 600 mg, gélule"
            },
            {
              "code": "MV00000806",
              "inn": "furosémide",
              "label": "FUROSEMIDE ARROW 40 mg, comprimé sécable"
            }
          ]
        },
        "condition": null,
        "type": "A prendre en compte",
        "patient": null,
        "warnings": [
          {
            "risk": "Majoration du risque d’hyponatrémie.",
            "guidelines": [],
            "modifiers": []
          }
        ]
      },
      {
        "designation": "hyperkaliémiants <> autres hyperkaliémiants",
        "source": {
          "author": "Thesaurus - ANSM",
          "url": "https://ansm.sante.fr/uploads/2020/10/27/20201027-thesaurus-referentiel-national-des-interactions-medicamenteuses-20102020.pdf"
        },
        "drugs": {
          "clinicalDrugs": [
            {
              "code": "MV00001780",
              "inn": "potassium (chlorure de)",
              "label": "DIFFU-K 600 mg, gélule"
            }
          ]
        },
        "condition": null,
        "type": "A prendre en compte",
        "patient": null,
        "warnings": [
          {
            "risk": "Risque de majoration de l’hyperkaliémie, potentiellement létale.",
            "guidelines": [],
            "modifiers": []
          }
        ]
      },
      {
        "designation": "hyperkaliémiants <> autres hyperkaliémiants",
        "source": {
          "author": "Thesaurus - ANSM",
          "url": "https://ansm.sante.fr/uploads/2020/10/27/20201027-thesaurus-referentiel-national-des-interactions-medicamenteuses-20102020.pdf"
        },
        "drugs": {
          "clinicalDrugs": [
            {
              "code": "MV00001780",
              "inn": "potassium (chlorure de)",
              "label": "DIFFU-K 600 mg, gélule"
            },
            {
              "code": "MV00000353",
              "inn": "ramipril",
              "label": "RAMIPRIL KRKA 1,25 mg, comprimé"
            }
          ]
        },
        "condition": null,
        "type": "A prendre en compte",
        "patient": null,
        "warnings": [
          {
            "risk": "Risque de majoration de l’hyperkaliémie, potentiellement létale.",
            "guidelines": [],
            "modifiers": []
          }
        ]
      },
      {
        "designation": "diurétiques épargneurs de potassium (seuls ou associés) (sauf spironolactone, éplérénone) <> inhibiteurs de l'enzyme de conversion",
        "source": {
          "author": "Thesaurus - ANSM",
          "url": "https://ansm.sante.fr/uploads/2020/10/27/20201027-thesaurus-referentiel-national-des-interactions-medicamenteuses-20102020.pdf"
        },
        "drugs": {
          "clinicalDrugs": [
            {
              "code": "MV00001780",
              "inn": "potassium (chlorure de)",
              "label": "DIFFU-K 600 mg, gélule"
            },
            {
              "code": "MV00000353",
              "inn": "ramipril",
              "label": "RAMIPRIL KRKA 1,25 mg, comprimé"
            }
          ]
        },
        "condition": null,
        "type": "Association DECONSEILLEE",
        "patient": null,
        "warnings": [
          {
            "risk": "Risque d'hyperkaliémie (potentiellement létale) surtout en cas d'insuffisance rénale (addition des effets hyperkaliémiants).",
            "guidelines": [
              "Si l'association est justifiée, contrôle strict de la kaliémie et de la fonction rénale."
            ],
            "modifiers": []
          }
        ]
      },
      {
        "designation": "diurétiques hypokaliémiants <> inhibiteurs de l'enzyme de conversion",
        "source": {
          "author": "Thesaurus - ANSM",
          "url": "https://ansm.sante.fr/uploads/2020/10/27/20201027-thesaurus-referentiel-national-des-interactions-medicamenteuses-20102020.pdf"
        },
        "drugs": {
          "clinicalDrugs": [
            {
              "code": "MV00000806",
              "inn": "furosémide",
              "label": "FUROSEMIDE ARROW 40 mg, comprimé sécable"
            },
            {
              "code": "MV00000353",
              "inn": "ramipril",
              "label": "RAMIPRIL KRKA 1,25 mg, comprimé"
            }
          ]
        },
        "condition": null,
        "type": "Précaution d'Emploi",
        "patient": null,
        "warnings": [
          {
            "risk": "Risque d'hypotension artérielle brutale et/ou d'insuffisance rénale aiguë lors de l'instauration ou de l'augmentation de la posologie d'un traitement par un inhibiteur de l'enzyme de conversion en cas de déplétion hydrosodée préexistante.",
            "guidelines": [
              "Dans l'hypertension artérielle, lorsqu'un traitement diurétique préalable a pu entraîner une déplétion hydrosodée, il faut : \n- soit arrêter le diurétique avant de débuter le traitement par l'IEC, et réintroduire un diurétique hypokaliémiant si nécessaire ultérieurement ;\n- soit administrer des doses initiales réduites d'IEC et augmenter progressivement la posologie.\n\nDans l'insuffisance cardiaque congestive traitée par diurétiques, commencer par une dose très faible d'IEC, éventuellement après réduction de la dose du diurétique hypokaliémient associé. \n\nDans tous les cas : surveiller la fonction rénale (créatininémie) dans les premières semaines du traitement par l'IEC."
            ],
            "modifiers": []
          }
        ]
      }
    ]
  }
}

Codes de réponse

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