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 | gender | String | Sexe biologique du patient |
patient | ageGroups | String[] | 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 | AlertWithIngredientResult[] | 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 | String[] | Indique les intentions (première, deuxième ou troisième) pour lesquelles le médicament est une alternative |
treatmentTypes | String[] | Types de traitement pour lesquelles le médicament est une alternative |
therapies | String[] | 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 | String | 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": []
}
],
...
}
}Codes de réponse
| Code | Description |
|---|---|
200 | OK |
400 | Un des paramètres passés dans la requête est invalide |