Recommandations de Traitements

Introduction

La requête getAlternatives permet de récupérer les alternatives thérapeutiques valides pour une indication.

Point d’entrée

post/aort/v1/graphql

En-têtes HTTP

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

Variables

Pour saisir l’indication, utiliser l’autocomplete avec entity_type=CLINICAL_INDICATION.
Pour saisir les médicaments, utiliser l’autocomplete avec entity_type=DRUG.
Pour saisir les conditions, utiliser l’autocomplete avec entity_type=CONTRAINDICATION_TERRAIN.
Pour saisir les effets indésirables à éviter, utiliser l’autocomplete avec entity_type=ADVERSE_EFFECT.

Variable	Input field	Type	Description
`target`	`drug`	`DrugInput`	Médicament pour lequel on recherche une alernative
`target`	`indication`	`IndicationInput`	Indication pour laquelle on cherche une alternative thérapeutique
`target`	`level`	`Level`	Niveau de risque des alternatives, les alternatives ne seront proposées que pour les indications ne comportant pas d’alertes d’un niveau équivalent
`target`	`adverseEffectsToAvoid`	`CodingInputWithLabel[]`	Liste des codes des effets indésirables à éviter pour les alternatives
`target`	`pathways`	`CodingInputWithLabel[]`	Liste des codes des formes pour les alternatives
`target`	`forms`	`CodingInputWithLabel[]`	Liste des codes des voies pour les alternatives
`target`	`therapeuticBooklet`	`TherapeuticBooklet`	Configuration du livret thérapeutiques pour avoir les spécialités(packaged drugs) présentes au livret
`target`	`outOfStock`	`Boolean`	Filtre sur les ruptures de stock (pas encore implémenté)
`target`	`marketed`	`Boolean`	Filtre les médicaments ayant une autorisation de mise sur le marché
`patient`	`conditions`	`ConditionInput[]`	Pathologies et conditions du patient (SNOMED)
`patient`	`sex`	`Gender`	Sexe biologique du patient
`patient`	`ageGroups`	`AgeGroup[]`	Groupe d’age du patient
`patient`	`birthDate`	`Date`	Date de naissance du patient
`patient`	`continuousCriteria`	`ContinuousCriterionInput[]`	Paramètres biologiques du patient
`patient`	`concurrentTreatments`	`AlternativeTreatmentInput`	Traitements pré-existants chez le patient
`snomedInferrence`	`indication`	`Boolean`	Paramètre permettant de chercher les alternatives sur les indications proches via des inférences permises par la SNOMED.
`snomedInferrence`	`alerts`	`Boolean`	Paramètre permettant de chercher les alertes sur les conditions proches via des inférences permises par la SNOMED.
`snomedInferrence`	`adverseEffects`	`Boolean`	Paramètre permettant de chercher les effets indésirables via des inférences permises par la SNOMED.

ContinuousCriterionInput

Input field	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
`value`	`Float`	Valeur absolue du paramètre biologique

ConcurrentTreatments

Input field	Type	Description
`ingredients`	`String[]`	Ingrédients des médicaments pré-existants chez le patient
`procedures`	`String[]`	Procédures et opérations dans l’histoire du patient
`therapeuticClasses`	`String[]`	Classes thérapeutiques des traitements pris par le patient

Résultat

L’API renvoie un objet de type AlternativeResult.

Alternative Result

Attributs	Type	Description
`drug`	`AlternativeDrug`	Description de chaque médicament d’une alternative
`alerts`	`AlertResult[]`	Liste des contre-indications restantes pour chaque alternative
`interactions`	`InteractionResult[]`	Liste des interactions restantes pour chaque alternative
`adversesEffects`	`AdverseEffect[]`	Liste des effets indésirables restants pour chaque alternative
`indications`	`IndicationResult[]`	Détails sur l’indication pour pouvoir remplir les filtres

AlternativeDrug

Attributs	Type	Description
`clinicalDrug`	`ClinicalDrug`	Détails sur le médicament virtuel proposé en alternative
`brandedDrugs`	`BrandedDrug[]`	Liste des noms de marques des médicaments
`ingredients`	`String[]`	Liste de désignation des ingrédients

ClinicalDrug

Attributs	Type	Description
`codings`	`Coding[]`	Codes supplémentaires pour décrire le mécicament
`form`	`Coding`	Forme du médicament
`routes`	`Coding[]`	Voies d’administation possibles pour ce médicament
`inn`	`String`	Dénomination commune internationale
`marketed`	`Boolean`	Si le médicament est mis sur le marché
`historicalSales`	`HistoricalSales`	historique des ventes du médicament

HistoricalSales

Attributs	Type	Description
`atc5`	`Int`	Historique des ventes pour l’ATC5
`atc7`	`Int`	Historique des ventes pour l’ATC7

TherapeuticUseResult

Attributs	Type	Description
`intents`	`Intent[]`	Indique les intentions (première, deuxième ou troisième) pour lesquelles le médicament est une alternative
`treatmentTypes`	`TreatmentType[]`	Types de traitement pour lesquelles le médicament est une alternative
`therapies`	`Therapy[]`	Types de thérapie pour lesquelles le médicament est une alternative

BrandedDrug

Attributs	Type	Description
`code`	`Coding`	Code de la spécialité (branded drug)
`brandname`	`String`	Nom de marque de la spécialité
`therapeuticBooklet`	`Boolean`	Si vrai, filtre les spécialités pour n’affiche que celles présentes au livret
`outOfStock`	`Boolean`	Si vrai, filtre les spécialités pour n’affiche que celles en stock (Pas encore implémenté)

AdverseEffect

Attributs	Type	Description
`condition`	`Condition`	Condition décrivant l’effet indésirable
`incidence`	`Incidence`	incidence de l’effect indésirable
`patient`	`Patient`	Critères patient pour lesquels l’effet indésirable a cette incidence
`dosage`	`String`	Dose de mécicament propice à la survenue de l’effet indésirable
`phase`	`String`	Phase du traitement propice à la survenue de l’effect indésirable
`behaviour`	`String`	Conduite à tenir en cas de survenue de l’effet indésirable

IndicationResult

Attributs	Type	Description
`condition`	`Condition`	Condition de l’indication thérapeutique
`therapeuticUse`	`TherapeuticUse`	Détails de l’usage thérapeutique de l’indication

Exemple

Alternatives

query getAlternatives($target: AlternativeTarget) {
  getAlternatives(target: $target) {
    drug {
      clinicalDrug {
        inn
        codings {
          code
          label
          terminology
        }
        form {
          code
          label
          terminology
        }
        routes {
          code
          label
          terminology
        }
        marketed
        historicalSales {
          atc5
          atc7
        }
      }
      brandedDrugs {
        brandname
        code {
          code
          label
          terminology
        }
        outOfStock
        therapeuticBooklet
      }
      ingredients
    }
    indications {
      condition {
        designation
        codings {
          code
          label
          terminology
        }
        associatedConditions {
          designation
          codings {
            code
            label
            terminology
          }
          
          modifiers
        }
        modifiers
      }
      therapeuticUse {
        intents
        therapies
        treatmentTypes
      }
    }
    alerts {
      designation
      type
      condition {
        designation
        codings {
          code
          label
          terminology
        }
        associatedConditions {
          designation
          codings {
            code
            label
            terminology
          }
          modifiers
        }
        modifiers
      }
      patient {
        ageGroups
        gender
        concurrentTreatments {
          ingredients
          procedures
          therapeuticClasses
        }
        continuousCriteria {
          type
          min
          max
          unit
        }
      }
      warnings {
        risk
        modifiers
        guidelines
      }
      source {
        author
        url
      }
      comment
    }
    interactions {
      designation
      type
      drugs {
        ingredient {
          code
          label
          terminology
        }
        clinicalDrug {
          inn
          code
          label
          terminology
        }
        brandedDrug {
          code
          label
          terminology
        }
        brandedDrug {
          code
          label
          terminology
        }
      }
      comment
      source {
        author
        url
      }
    }
    adverseEffects {
      condition {
        designation
        codings {
          code
          label
          terminology
        }
        associatedConditions {
          designation
          codings {
            code
            label
            terminology
          }
          modifiers
        }
        modifiers
      }
      incidence
      patient {
        ageGroups
        gender
        concurrentTreatments {
          ingredients
          procedures
          therapeuticClasses
        }
        continuousCriteria {
          type
          min
          max
          unit
        }
      }
      phase
      dosage
      behaviour
    }
  }
}

Réponse

  {
  "data": {
    "getAlternatives": [
      {
        "drug": {
          "clinicalDrug": {
            "inn": "glimépiride",
            "codings": [
              {
                "code": "MV00000125",
                "label": "Glimépiride 3 mg comprimé",
                "terminology": "posos"
              },
              {
                "code": "A10B",
                "label": "médicaments hypoglycémiants sauf insulines",
                "terminology": "ATC4"
              },
              {
                "code": "A10BB",
                "label": "sulfonylurées",
                "terminology": "ATC5"
              },
              {
                "code": "A10BB12",
                "label": "glimépiride",
                "terminology": "ATC7"
              }
            ],
            "form": {
              "code": "PDF-10219000",
              "label": "Comprimé",
              "terminology": "EDQM_form"
            },
            "routes": [
              {
                "code": "ROA-20053000",
                "label": "Voie orale",
                "terminology": "EDQM_pathway"
              }
            ],
            "marketed": true,
            "historicalSales": {
              "atc5": 9112677,
              "atc7": 1636144
            }
          },
          "brandedDrugs": [
            {
              "brandname": "glimepiride",
              "code": {
                "code": "61788049",
                "label": "GLIMEPIRIDE ACCORD HEALTHCARE 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "62969440",
                "label": "GLIMEPIRIDE ZYDUS 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "63235360",
                "label": "GLIMEPIRIDE ARROW 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "63422748",
                "label": "GLIMEPIRIDE ARROW GENERIQUES 3 mg, comprimé sécable",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "63718067",
                "label": "GLIMEPIRIDE CRISTERS 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "64816831",
                "label": "GLIMEPIRIDE EG 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "amarel",
              "code": {
                "code": "65035230",
                "label": "AMAREL 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "65546901",
                "label": "GLIMEPIRIDE ZENTIVA 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "65607350",
                "label": "GLIMEPIRIDE SANDOZ 3 mg, comprimé sécable",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "65660794",
                "label": "GLIMEPIRIDE TEVA SANTE 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "67447122",
                "label": "GLIMEPIRIDE EVOLUGEN 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "68427382",
                "label": "GLIMEPIRIDE BGR 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            },
            {
              "brandname": "glimepiride",
              "code": {
                "code": "69977393",
                "label": "GLIMEPIRIDE VIATRIS 3 mg, comprimé",
                "terminology": "cis"
              },
              "outOfStock": false,
              "therapeuticBooklet": false
            }
          ],
          "ingredients": null
        },
        "indications": [
          {
            "condition": {
              "designation": null,
              "codings": [
                {
                  "code": "10022491",
                  "label": "Diabète insulinorésistant",
                  "terminology": "meddra"
                },
                {
                  "code": "44054006",
                  "label": "diabète sucré de type 2",
                  "terminology": "snomed"
                },
                {
                  "code": "E11",
                  "label": "Diabète sucré de type 2",
                  "terminology": "cim10"
                }
              ],
              "associatedConditions": null,
              "modifiers": []
            },
            "therapeuticUse": {
              "intents": [],
              "therapies": [],
              "treatmentTypes": []
            }
          }
        ],
        "alerts": [],
        "interactions": [],
        "adverseEffects": []
      }
    ],
    ...
  }
}

Enum

Gender

Variable	Description
M	Homme
F	Femme

AgeGroup

Variable	Description
NEWBORN	Nouveau-né
SENIOR	Sénior
CHILD	Enfant
ADOLESCENT	Adolescent
PREMATURE	Prématuré
INFANT	Nourrisson
ADULT	Adulte

Intent

Variable	Description
FIRST_LINE	Première intention
SECOND_LINE	Seconde intention
THIRD_LINE	Troisième intention

TreatmentType

Variable	Description
ACUTE	Traitement ponctuel
ADJUVANT	Traitement adjuvant
CONTINUATION	Traitement curatif
CURATIVE	Traitement curatif
DIAGNOSIS	Agent de diagnostic
EMERGENCY	Traitement d’urgence
ETIOLOGICAL	Traitement éthiologique
HOMEOPATHY	Traitement homéopathique
IMMUNOMODULATOR	Traitement immunomodulateur
INDUCTION	Traitement d’induction
INITIAL	Traitement d’attaque
LOCAL	Traitement local
LONG_TERM_DISEASE_MODIFYING	Traitement de fond
MAINTENANCE	Traitement d’entretien
MANAGEMENT	Traitement de management
PALLIATIVE	Traitement palliatif
PHYTOTHERAPY	Traitement de phytothérapie
PREVENTIVE	Traitement préventif
REPLACEMENT	Traitement substitutif
REVERSAL	Traitement d’inversion
SYMPTOMATIC	Traitement symptomatique
VACCINE	Vaccin

Therapy

Variable	Description
MONOTHERAPY	Monotherapy treatment type
BITHERAPY	Bitherapy treatment type
TRITHERAPY	Tritherapy treatment type
COMBINATION_THERAPY	Multitherapy treatment type

Codes de réponse

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

Interactions Système d'aide à la décision indexé par médicament (HAS)