Recherche de ressources FHIR avec GET - AWS HealthLake
Exemples de recherche GET

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Recherche de ressources FHIR avec GET

Vous pouvez utiliser des GET requêtes pour effectuer une recherche dans un magasin de HealthLake données. Lors de l'utilisationGET, HealthLake prend en charge la fourniture de paramètres de recherche dans le cadre de l'URL, mais pas dans le corps d'une requête. Pour de plus amples informations, veuillez consulter Paramètres de recherche FHIR R4 pour HealthLake.

Important

Pour les recherches impliquant des informations personnelles identifiables (PII) ou des informations de santé protégées (PHI), les meilleures pratiques en matière de sécurité nécessitent l'utilisation de POST demandes, car les informations personnelles et les PHI sont ajoutées dans le corps de la demande et sont cryptées pendant le transfert. Pour de plus amples informations, veuillez consulter Recherche de ressources FHIR avec POST.

La procédure suivante est suivie d'exemples utilisés GET pour effectuer des recherches dans un magasin de HealthLake données.

Pour effectuer une recherche dans un magasin de HealthLake données avec GET

  1. Collectez HealthLake region et datastoreId valorisez. Pour de plus amples informations, veuillez consulter Obtenir les propriétés du magasin de données.

  2. Déterminez le type de ressource FHIR à rechercher et collectez la id valeur associée. Pour de plus amples informations, veuillez consulter Types de ressource.

  3. Construisez une URL pour la demande en utilisant les valeurs collectées pour HealthLake region etdatastoreId. Incluez également le Resource type FHIR et les paramètres de recherche pris en charge. Pour afficher le chemin complet de l'URL dans l'exemple suivant, faites défiler le curseur sur le bouton Copier.

    GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource{?[parameters]{&_format=[mime-type]}}

  4. Envoyez la GET demande avec AWS Signature Version 4 ou SMART sur autorisation FHIR. L'curlexemple suivant renvoie le nombre total de Patient ressources dans un magasin de HealthLake données. Pour afficher l'exemple dans son intégralité, faites défiler la souris sur le bouton Copier.

    SigV4

    Autorisation SigV4

    curl --request GET \
  'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?_total=accurate' \   
  --aws-sigv4 'aws:amz:region:healthlake' \
  --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
  --header "x-amz-security-token:$AWS_SESSION_TOKEN" \                          
  --header 'Accept: application/json'
    SMART on FHIR

    Exemple d'autorisation SMART sur FHIR pour le type de IdentityProviderConfigurationdonnées.

    {
    "AuthorizationStrategy": "SMART_ON_FHIR",
    "FineGrainedAuthorizationEnabled": true,
    "IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name",
    "Metadata": "{\"issuer\":\"https://ehr.example.com\", \"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credential\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openId\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\",\"permission-v2\"]}"
}

    L'appelant peut attribuer des autorisations dans le lambda d'autorisation. Pour de plus amples informations, veuillez consulter OAuth Éscopes 2.0.

    AWS Console
    Note

    La HealthLake console prend uniquement en charge l'autorisation SigV4. L'autorisation SMART on FHIR est prise en charge via AWS CLI et AWS SDKs.

    1. Connectez-vous à la page Exécuter une requête sur la HealthLake console.

    2. Dans la section Paramètres de requête, effectuez les sélections suivantes.

    • ID du magasin de données : choisissez un identifiant de magasin de données pour générer une chaîne de requête.

    • Type de requête : choisissezSearch with GET.

    • Type de ressource : choisissez le type de ressource FHIR sur lequel effectuer la recherche.

    • Paramètres de recherche : sélectionnez un paramètre de recherche ou une combinaison de paramètres de recherche pour concentrer votre recherche sur des enregistrements spécifiques.

    3. Choisissez Exécuter la requête.

Exemples : recherche avec GET

Les onglets suivants fournissent des exemples de recherche sur des types de ressources FHIR spécifiques avecGET. Les exemples montrent comment spécifier les paramètres de recherche dans la demande URLs.

Note

La HealthLake console prend uniquement en charge l'autorisation SigV4. L'autorisation SMART on FHIR est prise en charge via AWS CLI et AWS SDKs.

HealthLake prend en charge un sous-ensemble de paramètres de recherche FHIR R4. Pour de plus amples informations, veuillez consulter Paramètres de recherche.

Patient (age)

Bien que l'âge ne soit pas un type de ressource défini dans le FHIR, il est capturé en tant qu'élément du type de Patientressource. Utilisez l'exemple suivant pour effectuer une demande de recherche GET basée sur les types de Patientressources à l'aide de l'élément BirthDate et du eq comparateur de recherche pour rechercher des personnes nées en 1997.

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?birthdate=eq1997
Condition

Utilisez l'exemple suivant pour effectuer une GET demande sur le type de Conditionressource. La recherche permet de trouver dans votre banque de HealthLake données les conditions qui contiennent le code médical SNOMED72892002, qui se traduit par. Normal pregnancy

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition?code=72892002
DocumentationReference

L'exemple suivant montre comment créer une GET demande sur le type de DocumentReferenceressource pour Patient les personnes ayant reçu un diagnostic de streptocoque et à qui l'amoxicilline a également été prescrite.

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/DocumentReference?_lastUpdated=le2021-12-19&infer-icd10cm-entity-text-concept-score;=streptococcal|0.6&infer-rxnorm-entity-text-concept-score=Amoxicillin|0.8
Location

Utilisez l'exemple suivant pour effectuer une GET demande sur le type de Locationressource. La recherche suivante permet de trouver les emplacements de votre banque de HealthLake données dont l'adresse contient le nom de ville Boston.

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location?address=boston
Observation

Utilisez l'exemple suivant pour effectuer une demande de recherche GET basée sur le type de Observationressource. Cette recherche utilise le paramètre value-concept de recherche pour rechercher le code médical266919005, qui se traduit parNever smoker.

GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation?value-concept=266919005