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), 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

NomValeur
Content-Typeapplication/json
AuthorizationBearer <token>

Variables

Pour saisir les médicaments, utiliser l'autocomplete avec entity_type=DRUG.
Pour saisir les conditions, utiliser l'autocomplete avec entity_type=CONTRAINDICATION_TERRAIN.

VariableInput fieldTypeDescription
drugsDrugInput[]Liste des medicaments à analyser
patientageGroupsString[]Le groupe d'âge auquel le patient appartient
patientbirthDateDateDate de naissance du patient
patientconcurrentTreatmentsTreatmentInputTraitements pré-existants chez le patient
patientconditionsConditionInput[]Pathologies et conditions du patient (SNOMED)
patientgenderStringSexe biologique du patient
patientcontinuousCriteriaContinuousCriterionInput[]Paramètres biologiques du 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
proceduresString[]Procédures et opérations dans l'histoire du patient
therapeuticClassesString[]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
warningsWarning[]Liste des mises en gardes
drugsDrug[]Ensemble des médicaments responsables de la contre-indication
commentStringInformation complémentaire pour comprendre la contre-indication
sourceSourceSource de la contre-indication

Drug

AttributsTypeDescription
brandedDrugCodingCode désignant une spécialité
clinicalDrugCodingWithInnCode désignant un médicament clinique
ingredientCodingCode désignant un ingredient
packagedDrugCodingCode désignant un médicament

Coding

AttributsTypeDescription
codestringCode de cette entité dans la terminologie
labelstringLabel de cette entité dans la terminologie
terminologystringIdentifiant de la terminologie, valable à travers la base

CodingWithInn

AttributsTypeDescription
codestringCode de cette entité dans la terminologie
labelstringLabel de cette entité dans la terminologie
terminologystringIdentifiant de la terminologie, valable à travers la base
innstringCode de l'identifiant INN

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.

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.

AttributsTypeDescription
genderStringSexe biologie du patient. Cet objet est un Enum avec comme valeur possible Homme ou Femme
ageGroupsString[]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.
therapeuticClassesString[]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 {
      clinicalDrug {
        code
        inn
        label
        terminology
      }
    }
    condition {
      designation
      modifiers
      associatedConditions {
        designation
        modifiers
      }
    }
    patient {
      ageGroups
      continuousCriteria {
        type
        unit
        min
        max
      }
    }
    warnings {
      modifiers
      guidelines
      risk
    }
  }
}

Contre-indications-variables

{
  "drugs": [
    { "clinicalDrug": {"code": "MV00003202", "terminology": "posos"}
  }],
  "patient": {
    "conditions": [
      {
        "coding": {
          "code": "289908002"
        }
      }
    ]
  }
}

Réponse

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

Codes de réponse

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