APIs
Référence API
Analyse
Contre-indications

Analyse de contre-indications

Introduction

La requête getContraindications permet de récupérer les contre-indications liées à un médicament clinique (aka médicament virtuel), une spécialité (CIS).

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
drugsspecialitiesString[]Liste de spécialités à analyser (CIS)
patientpathologiesString[]Pathologies et conditions du patient (SNOMED)
patientgenderStringSexe biologique du patient
patientbirthDateDateDate de naissance du patient
patientcontinuousCriteria[ContinuousCriterionInput]Paramètres biologiques du patient
patientconcurrentTreatmentsTreatmentInputTraitements pré-existants chez le patient
typesString[]Type et niveau d'alerte
snomedInferrenceBooleanParamètre permettant de chercher les alertes sur les conditions proches via des inférences permises par la SNOMED.

ContinuousCriterionInput

Input fieldTypeDescription
typeStringType de paramètre biologique
unitStringUnité du paramètre biologique
minFloatBorne inférieure du paramètre biologique
maxFloatBorne supérieure du paramètre biologique
valueFloatValeur absolue du paramètre biologique

ConcurrentTreatments

Input fieldTypeDescription
ingredientsString[]Ingrédients des médicaments pré-existants chez le patient
procedureString[]Procédures et opérations dans l'histoire du patient
therapeuticClassString[]Classes thérapeutiques des traitements pris par le patient

Résultat

L'API renvoie un objet de type AlertResult.

AlertResult

AttributsTypeDescription
designationStringLa designation de la contre-indication. La designation contient les deux groupes déclencheurs séparés par <>
typeStringType de conte-indication (Précaution d'emploi, Contre-Indication, Association DECONSEILLEE, ...)
conditionStringCondition médicale concernée
patientStringCritères patients de la contre-indication
warnings[Warning]Liste des mises en gardes
drugsDrugEnsemble des médicaments responsables de la contre-indication
commentStringInformation complémentaire pour comprendre la contre-indication
sourceSourceSource de la contre-indication

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, valable à travers la base

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

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

AttributsTypeDescription
designationStringNom de la condition médicale
associatedConditionsAssociatedCondition[]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.
modifiersString[]Objet précisant la sévérité, l'état, l'intensité, la chronologie ou la localisation d'une condition. Cet objet est un Enum.
codingsCoding[]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.

PatientProfile

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.

AttributsTypeDescription
genderStringSexe biologie du patient. Cet objet est un Enum avec comme valeur possible Homme ou Femme
ageGroupString[]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.
continuousCriteriaContinuousCriterion[]Mesure décrivant l'état du patient.

Treatment

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

AttributsTypeDescription
ingredientsString[]Substance rattachée à l'objet Treatment. Le format de cet objet est décrit dans Ingredient.
proceduresString[]Procédure rattachée à l'objet Treatment. Cet objet a la forme d'un Coding dont la terminologie est Meddra.
therapeuticClassString[]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.

AttributsTypeDescription
typeStringType de paramètre biologique
unitStringUnité du paramètre biologique
minFloatBorne inférieure du paramètre biologique
maxFloatBorne supérieure du paramètre biologique

Exemple

Contre-indications

query getContraindications($drugs: DrugInput, $patient: PatientInput) {
  getContraindications(drugs: $drugs, patient: $patient) {
    designation
    type
    source {
      author
      url
    }
    drugs {
      clinicalDrugs {
        code
        inn
        label
        terminology
      }
    }
    condition {
      designation
      modifiers
      associatedConditions {
        designation
        modifiers
      }
    }
    patient {
      ageGroup
      continuousCriteria {
        type
        unit
        min
        max
      }
    }
    warnings {
      modifiers
      guidelines
      risk
    }
  }
}

Réponse

{
  "data": {
    "getContraindications": [
      {
        "designation": "Grossesse",
        "type": "Contre-indication Absolue",
        "source": {
          "author": "RCP",
          "url": "https://ec.europa.eu/health/documents/community-register/2022/20220902156865/anx_156865_fr.pdf"
        },
        "drugs": {
          "clinicalDrugs": [
            {
              "code": "MV00003202",
              "inn": "sitagliptine (phosphate de) monohydraté",
              "label": "XELEVIA 50 mg, comprimé pelliculé",
              "terminology": null
            }
          ]
        },
        "condition": {
          "designation": "Grossesse",
          "modifiers": [],
          "associatedConditions": []
        },
        "patient": {
          "ageGroup": [],
          "continuousCriteria": []
        },
        "warnings": []
      }
    ]
  }
}

Codes de réponse

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