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
| Variable | Input field | Type | Description |
|---|---|---|---|
target | clinicalDrug | String | Identifiant de clinical drug(ex: "MV00002338") pour lequel on recherche une alternative à exclure des résultats |
target | indication | ConditionInput | 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 | adverseEffectToAvoid | CodingInput | Liste des codes des effets indésirables à éviter pour les alternatives |
target | pathway | CodingInput | Liste des codes des formes pour les alternatives |
target | form | CodingInput | 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 | pathologies | String[] | Pathologies et conditions du patient (SNOMED) |
patient | gender | String | Sexe biologique du patient |
patient | ageGroup | String[] | Groupe d'age du patient |
patient | birthDate | Date | Date de naissance du patient |
patient | continuousCriteria | ContinuousCriterionInput[] | Paramètres biologiques du patient |
patient | concurrentTreatments | TreatmentInput | 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 |
procedure | String[] | Procédures et opérations dans l'histoire du patient |
therapeuticClass | 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 | AlertResult | 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 | [Code] | Codes supplémentaires pour décrire le mécicament |
form | String | Forme du médicament |
pathways | [String] | 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 | Code | 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 | PatientProfile | 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 | TherapeuticUseResult | 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
pathways
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 {
ageGroup
gender
concurrentTreatments {
ingredients
procedure
therapeuticClass
}
continuousCriteria {
type
min
max
unit
}
}
warnings {
risk
modifiers
guidelines
}
source {
author
url
}
comment
}
interactions {
designation
type
drugs {
clinicalDrugs {
inn
code
label
terminology
}
brandnames
ingredients
specialities {
code
label
terminology
}
}
comment
source {
author
url
}
}
adverseEffects {
condition {
designation
codings {
code
label
terminology
}
associatedConditions {
designation
codings {
code
label
terminology
}
modifiers
}
modifiers
}
incidence
patient {
ageGroup
gender
concurrentTreatments {
ingredients
procedure
therapeuticClass
}
continuousCriteria {
type
min
max
unit
}
}
phase
dosage
behaviour
}
}
}Réponse
{
"data": {
"getAlternatives": [
{
"drug": {
"clinicalDrug": {
"inn": "bumétanide",
"codings": [
{
"code": "MV00002338",
"label": "Bumétanide 5 mg comprimé",
"terminology": "posos"
},
],
"form": "Comprimé",
"pathways": [
"Orale"
],
"marketed": true,
"historicalSales": {
"atc5": 18380045,
"atc7": 299948
}
},
"brandedDrugs": [
{
"brandname": "burinex",
"code": {
"code": "67563415",
"label": "BURINEX 5 mg, comprimé",
"terminology": "cis"
},
"outOfStock": false,
"therapeuticBooklet": false
}
],
"ingredients": null
},
"indications": [
{
"condition": {
"codings": [
{
"code": "84114007",
"label": "insuffisance cardiaque",
"terminology": "snomed"
},
],
"associatedConditions": null,
"modifiers": [
"Sévère"
]
},
"therapeuticUse": {
"intents": [
"Seconde intention"
],
"therapies": [],
"treatmentTypes": []
}
}
],
"alerts": [],
"interactions": [],
"adverseEffects": []
},
...
{
"drug": {
"clinicalDrug": {
"inn": "périndopril",
"codings": [
{
"code": "MV00003966",
"label": "Périndopril tosilate 2,5 mg comprimé",
"terminology": "posos"
},
{
"code": "C09A",
"label": "inhibiteurs de l'enzyme de conversion (IEC) non associés",
"terminology": "ATC4"
},
{
"code": "C09AA",
"label": "inhibiteurs de l'enzyme de conversion (IEC) non associés",
"terminology": "ATC5"
},
{
"code": "C09AA04",
"label": "périndopril",
"terminology": "ATC7"
}
],
"form": "Comprimé pelliculé",
"pathways": [
"Orale"
],
"marketed": true,
"historicalSales": {
"atc5": 19342505,
"atc7": 6895410
}
},
"brandedDrugs": [
{
"brandname": "perindopril tosilate",
"code": {
"code": "62525040",
"label": "PERINDOPRIL TOSILATE TEVA 2,5 mg, comprimé pelliculé",
"terminology": "cis"
},
"outOfStock": false,
"therapeuticBooklet": false
},
{
"brandname": "perindopril tosilate",
"code": {
"code": "62640879",
"label": "PERINDOPRIL TOSILATE CRISTERS 2,5 mg, comprimé pelliculé",
"terminology": "cis"
},
"outOfStock": false,
"therapeuticBooklet": false
}
],
"ingredients": null
},
"indications": [
{
"condition": {
"designation": null,
"codings": [
{
"code": "10007554",
"label": "Insuffisance cardiaque",
"terminology": "meddra"
},
{
"code": "84114007",
"label": "insuffisance cardiaque",
"terminology": "snomed"
},
{
"code": "I50",
"label": "Insuffisance cardiaque",
"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 |