APIs
Référence API
Analyse
Systè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 clinique (aka médicament virtuel), une spécialité (CIS) 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 (cliniques ou spécialités) à la requête getSam

ArgumentInputFieldTypeDescription
drugsclinicalDrugsString[]Liste des codes de médicaments cliniques à analyser
drugsspecialitiesString[]Liste des spécialités à analyser (CIS)
drugsingredientsIngredientInputListe des ingrédients à analyser
patientpathologiesString[]Pathologies et conditions du patient (SNOMED)
patientgenderStringSexe biologique du patient
patientbirthDateDateDate de naissance du patient
patientcontinuousCriteria[ContinuousCriterionInput]Paramètres biologiques du patient
patientconcurrentTreatmentsTreatmentInputTraitements préexistants chez le patient
patientageGroupString[]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).
softwareTypes[TargetedTherapySoftware]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: DrugInput)
{
  getSam(drugs: $drugs){
		sam {
			title
      identifier
      messageForhealthProfessionals {
        softwareType
        text
      }
      alternativeDrug
      status
      source
      contact
      updateDate
      validationDate
      versionNumber
		}
		alert {
	    designation
	    patient {
	      ageGroup
	      gender
	      continuousCriteria {
	        max
	        min
	        type
	        unit
	      }
	      concurrentTreatments {
	        ingredients
	        procedure
	        therapeuticClass
	      }
	    }
    }
  }
}

Réponse

{
  "data": {
    "getSAM" : [
      {
        "sam" : {
          "id": "2019_0028_19",
          "validation_date": "2019-02-13",
          "update_date": "Néant",
          "version": "V1.0",
          "status": "Actif",
          "messageForHealthProfessionals" : [
            {
              "LogicielsConcerné": "LAP_A",
              "text": "Pour ce médicament une fiche de l’INCa vous donne les messages clés de prévention et de gestion des effets indésirables."
            },
            {
              "LogicielsConcerné": "LAD_O",
              "text": "Pour ce médicament une fiche de l’INCa vous donne les messages clés de prévention et de gestion des effets indésirables."
            },
            {
              "LogicielsConcerné": "LAP_H",
              "text": "Pour ce médicament une fiche de l’INCa vous donne les messages clés de prévention et de gestion des effets indésirables."
            },
            {
              "LogicielsConcerné": "LAD_PUI",
              "text": "Pour ce médicament une fiche de l’INCa vous donne les messages clés de prévention et de gestion des effets indésirables."
            }
          ],
          "alternativeDrug": null,
          "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",
          "logo" : "https://www.has-sante.fr/upload/docs/image/png/2021-07/blobid0_2021-07-13_23-46-5_272.png",
 
        }
        "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": null
        }
      }
      ]
  }
}

Codes de réponse

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