Skip to content
APIsRéférence APIAnalyseSystème d'aide à la décision indexé par médicament (HAS)

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

Introduction

La requête getSam permet de récupérer les alertes indexées à un médicament (clinical, branded ou packaged drug) ou un ingrédient liés par la HAS.

Point d’entrée

post/aort/v1/graphql

En-têtes HTTP

NomValeur
Content-Typeapplication/json
AuthorizationBearer <token>

Arguments

Ces résultats s’obtiennent grâce à l’API d’analyse, il faut fournir une liste de médicaments (clinical, branded ou packaged drug) à la requête getSam

ArgumentInputFieldTypeDescription
drugsDrugInputWithIngredient[]Liste des codes de médicaments à analyser
patientconditionsCondition[]Pathologies et conditions du patient (SNOMED)
patientsexGenderSexe biologique du patient
patientbirthDateDateDate de naissance du patient
patientcontinuousCriteriaContinuousCriterionInput[]Paramètres biologiques du patient
patientconcurrentTreatmentsTreatmentInputTraitements préexistants chez le patient
patientageGroupsAgeGroup[]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).
patientobservationsObservationInput[]Liste des observations liées au patient
softwareTypesTargetedTherapySoftware[]Liste des types de logiciels d’aide à la décision

Résultat

L’API renvoie un objet de type SamResult.

AttributsTypeDescription
alertAlertResultAlerte qui correspond à la traduction de l’algorithme de déclenchement en critère patient et  médicaments de manière similaire aux autres objets Alert
samSamObjet qui contient toutes les informations du SAM concerné

Exemple

SAM

query GetSAM($drugs: [DrugInputWithIngredient])
  {
    getSam(drugs: $drugs){
      sam {
        title
        identifier
        messagesForHealthProfessionals {
          softwareType
          text
        }
        alternativeDrug
        status
        source
        contact
        updateDate
        validationDate
        versionNumber
      }
      alert {
        designation
        patient {
          ageGroups
          sex
          continuousCriteria {
            max
            min
            type
            unit
          }
          concurrentTreatments {
            ingredients
            procedures
            therapeuticClasses
          }
        }
      }
    }
  }
}

SAM

{
  "drugs": [
    {
      "clinicalDrug": {
        "code": "MV00003831",
        "terminology": "posos"
      }
    }
  ]
}

Response

{
  "data": {
    "getSam": [
      {
        "sam": {
          "title": "Rendre disponible aux professionnels de santé la fiche médicament sur la prévention et la gestion des effets indésirables du Vismodégib",
          "identifier": "2019_0028_19",
          "messagesForHealthProfessionals": null,
          "alternativeDrug": null,
          "status": "Actif",
          "source": "https://www.e-cancer.fr/Professionnels-de-sante/Medicaments/Prevention-suivi-et-gestion-des-effets-indesirables/Molecules-de-S-a-Z-d.c.i/Vismodegib",
          "contact": "ggrosjean@institutcancer.fr",
          "updateDate": null,
          "validationDate": "2019-02-13",
          "versionNumber": "V1.0"
        },
        "alert": {
          "designation": "Rendre disponible aux professionnels de santé la fiche médicament sur la prévention et la gestion des effets indésirables du Vismodégib",
          "patient": {
            "ageGroups": [],
            "sex": null,
            "continuousCriteria": [],
            "concurrentTreatments": {
              "ingredients": [],
              "procedures": [],
              "therapeuticClasses": []
            }
          }
        }
      }
    ]
  }
}

Enums

Gender

VariableDescription
MHomme
FFemme

AgeGroup

VariableDescription
NEWBORNNouveau-né
SENIORSénior
CHILDEnfant
ADOLESCENTAdolescent
PREMATUREPrématuré
INFANTNourrisson
ADULTAdulte

Codes de réponse

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