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 (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)
patientgenderStringSexe biologique du patient
patientbirthDateDateDate de naissance du patient
patientcontinuousCriteriaContinuousCriterionInput[]Paramètres biologiques du patient
patientconcurrentTreatmentsTreatmentInputTraitements préexistants chez le patient
patientageGroupsString[]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é

Example

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
	      gender
	      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": [],
            "gender": null,
            "continuousCriteria": [],
            "concurrentTreatments": {
              "ingredients": [],
              "procedures": [],
              "therapeuticClasses": []
            }
          }
        }
      }
    ]
  }
}

Codes de réponse

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