Pesquisando recursos do FHIR com GET - AWS HealthLake
Exemplos de pesquisa GET

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Pesquisando recursos do FHIR com GET

Você pode usar GET solicitações para pesquisar um armazenamento HealthLake de dados. Ao usarGET, HealthLake suporta o fornecimento de parâmetros de pesquisa como parte do URL, mas não como parte do corpo de uma solicitação. Para obter mais informações, consulte Parâmetros de pesquisa FHIR R4 para HealthLake.

Importante

Para pesquisas que envolvem informações de identificação pessoal (PII) ou informações de saúde protegidas (PHI), as melhores práticas de segurança exigem o uso de POST solicitações, pois PII e PHI são adicionadas como parte do corpo da solicitação e criptografadas em trânsito. Para obter mais informações, consulte Pesquisando recursos do FHIR com POST.

O procedimento a seguir é seguido por exemplos usados GET para pesquisar um armazenamento HealthLake de dados.

Para pesquisar um armazenamento HealthLake de dados com GET

  1. Colecione HealthLake region e datastoreId valorize. Para obter mais informações, consulte Obter propriedades do datastore.

  2. Determine o tipo de recurso FHIR para pesquisar e coletar o valor associadoid. Para obter mais informações, consulte Tipos de recursos.

  3. Crie uma URL para a solicitação usando os valores coletados para HealthLake region datastoreId e. Inclua também o Resource tipo de FHIR e os parâmetros de pesquisa compatíveis. Para ver todo o caminho do URL no exemplo a seguir, role até o botão Copiar.

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

  4. Envie a GET solicitação com AWS Signature Version 4 ou SMART na autorização FHIR. O curl exemplo a seguir retorna o número total de Patient recursos em um armazenamento HealthLake de dados. Para ver o exemplo inteiro, role até o botão Copiar.

    SigV4

    Autorização 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

    SMART no exemplo de autorização FHIR para o tipo de IdentityProviderConfigurationdados.

    {
    "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\"]}"
}

    O chamador pode atribuir permissões na autorização lambda. Para obter mais informações, consulte OAuth escopos 2.0.

    AWS Console
    nota

    O HealthLake console suporta somente a autorização SigV4. A autorização SMART on FHIR é suportada por meio de e. AWS CLI AWS SDKs

    1. Faça login na página Executar consulta no HealthLake console.

    2. Na seção Configurações da consulta, faça as seguintes seleções.

    • ID do armazenamento de dados — escolha um ID do armazenamento de dados para gerar uma sequência de caracteres de consulta.

    • Tipo de consulta — escolhaSearch with GET.

    • Tipo de recurso — escolha o tipo de recurso FHIR para pesquisar.

    • Parâmetros de pesquisa — Selecione um parâmetro de pesquisa ou uma combinação de parâmetros de pesquisa para focar sua consulta em registros específicos.

    3. Selecione Executar consulta.

Exemplos: pesquisar com GET

As guias a seguir fornecem exemplos para pesquisar tipos específicos de recursos do FHIR com. GET Os exemplos mostram como especificar parâmetros de pesquisa na solicitação URLs.

nota

O HealthLake console suporta somente a autorização SigV4. A autorização SMART on FHIR é suportada por meio de e. AWS CLI AWS SDKs

HealthLake suporta um subconjunto de parâmetros de pesquisa FHIR R4. Para obter mais informações, consulte Parâmetros de pesquisa.

Patient (age)

Embora a idade não seja um tipo de recurso definido no FHIR, ela é capturada como um elemento no tipo de Patientrecurso. Use o exemplo a seguir para fazer uma solicitação de pesquisa GET baseada em tipos de Patientrecursos usando o elemento BirthDate e o eq comparador de pesquisa para pesquisar indivíduos nascidos no ano de 1997.

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

Use o exemplo a seguir para fazer uma GET solicitação sobre o tipo de Conditionrecurso. A pesquisa encontra condições em seu armazenamento de HealthLake dados que contêm o código médico SNOMED72892002, que se traduz em. Normal pregnancy

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

O exemplo a seguir mostra como criar uma GET solicitação sobre o tipo de DocumentReferencerecurso para Patient (s) com diagnóstico de estreptococos e para quem também foi prescrita amoxicilina.

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

Use o exemplo a seguir para fazer uma GET solicitação sobre o tipo de Locationrecurso. A pesquisa a seguir encontra locais em seu armazenamento de HealthLake dados que contêm o nome da cidade Boston como parte do endereço.

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

Use o exemplo a seguir para fazer uma solicitação de pesquisa GET baseada no tipo de Observationrecurso. Essa pesquisa usa o parâmetro de value-concept pesquisa para procurar o código médico266919005, que se traduz em. Never smoker

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