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
drugsDrugInputWithIngredient[]Liste des médicaments à analyser
typesString[]Type et niveau d'alerte

DrugInputWithIngredient

Object contenant le médicament à analyser. Le médicament peut être soit un ingredient, une clinical drug, une branded drug ou une packaged drug.

FieldTypeDescription
ingredientCodingInputWithLabelCode of the ingredient
clinicalDrugCodingInputCode of the clinical drug
brandedDrugCodingInputCode of the branded drug
packagedDrugCodingInputCode of the packaged drug

Résultat

L'API renvoie un objet de type AlertWithIngredientResult.

AlertWithIngredientResult

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
warningsWarning[]Liste des mises en gardes
drugsDrugWithIngredient[]Ensemble des médicaments responsables de l'interaction
commentStringToujours null pour les interactions
sourceSourceSource de l'interaction

Drug

AttributsTypeDescription
ingredientCodingCodes de l'ingrédient
clinicalDrugCodingWithInnCode de la clinical drug
brandedDrugCodingCode de la branded drug
packagedDrugCodingCode de la packaged drug

Coding

AttributsTypeDescription
codeStringCode de cette entité dans la terminologie
labelStringLabel de cette entité dans la terminologie
terminologyStringIdentifiant de la terminologie

Coding

AttributsTypeDescription
codeStringCode de cette entité dans la terminologie
labelStringLabel de cette entité dans la terminologie
terminologyStringIdentifiant de la terminologie
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: [DrugInputWithIngredient]) {
  getInteractions(drugs: $drugs) {
    designation
    source {
      author
      url
    }
    drugs {
      clinicalDrug {
        inn
        code
        label
      }
    }
    type
    patient {
      ageGroups
      gender
      continuousCriteria {
        max
        min
        type
        unit
      }
      concurrentTreatments {
        ingredients
        procedures
        therapeuticClasses
      }
    }
    warnings {
      risk
      guidelines
      modifiers
    }
  }
}

Interactions-variables

{
  "drugs": [
    {
      "clinicalDrug": {
        "code": "MV00003865",
        "terminology": "posos"
      }
    },
    {
      "clinicalDrug": {
        "code": "MV00002488",
        "terminology": "posos"
      }
    },
    {
      "clinicalDrug": {
        "code": "MV00000353",
        "terminology": "posos"
      }
    },
    {
      "clinicalDrug": {
        "code": "MV00000806",
        "terminology": "posos"
      }
    },
    {
      "clinicalDrug": {
        "code": "MV00001780",
        "terminology": "posos"
      }
    }
  ]
}

Interactions-response

{
  "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": [
          {
            "clinicalDrug": {
              "inn": "chlorure de potassium",
              "code": "MV00001780",
              "label": "Potassium chlorure 600 mg gélule à libération prolongée"
            }
          },
          {
            "clinicalDrug": {
              "inn": "ramipril",
              "code": "MV00000353",
              "label": "Ramipril 1,25 mg comprimé"
            }
          }
        ],
        "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": "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": [
          {
            "clinicalDrug": {
              "inn": "chlorure de potassium",
              "code": "MV00001780",
              "label": "Potassium chlorure 600 mg gélule à libération prolongée"
            }
          },
          {
            "clinicalDrug": {
              "inn": "ramipril",
              "code": "MV00000353",
              "label": "Ramipril 1,25 mg comprimé"
            }
          }
        ],
        "type": "A prendre en compte",
        "patient": null,
        "warnings": [
          {
            "risk": "Risque de majoration de l’hyperkaliémie, potentiellement létale.",
            "guidelines": [],
            "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": [
          {
            "clinicalDrug": {
              "inn": "furosémide",
              "code": "MV00000806",
              "label": "Furosémide 40 mg comprimé"
            }
          },
          {
            "clinicalDrug": {
              "inn": "ramipril",
              "code": "MV00000353",
              "label": "Ramipril 1,25 mg comprimé"
            }
          }
        ],
        "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