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 POST
Você pode usar a searchinteração do FHIR com POST solicitações para pesquisar um armazenamento de HealthLake dados. Ao usarPOST, HealthLake oferece suporte a parâmetros de pesquisa no URL ou no corpo da solicitação, mas você não pode usar os dois em uma única solicitação.
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.
O procedimento a seguir é seguido por exemplos usando a search interação do FHIR R4 com POST para pesquisar um HealthLake armazenamento de dados. Os exemplos mostram como especificar parâmetros de pesquisa no corpo da solicitação JSON.
Para pesquisar um armazenamento HealthLake de dados com POST
-
Colecione HealthLake region e datastoreId valorize. Para obter mais informações, consulte Obter propriedades do datastore.
-
Determine o tipo de recurso FHIR para pesquisar e coletar o valor associadoid. Para obter mais informações, consulte Tipos de recursos.
-
Crie uma URL para a solicitação usando os valores coletados para HealthLake region datastoreId e. Inclua também o Resource tipo e _search a interação do FHIR. Para ver todo o caminho do URL no exemplo a seguir, role até o botão Copiar.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/_search
-
Crie um corpo JSON para a solicitação, especificando os dados FHIR a serem pesquisados. Para fins deste procedimento, você buscará Observation recursos para descobrir pacientes que nunca fumaram. Para especificar o status do código médicoNever smoker, defina value-concept=266919005 no corpo da solicitação JSON. Salve o arquivo como search-observation.json.
value-concept=266919005
-
Envie a solicitação . A search interação FHIR usa a GET solicitação com AWS Signature Version 4 ou SMART na autorização FHIR.
Ao fazer uma POST solicitação com parâmetros de pesquisa no corpo da solicitação, use Content-Type: application/x-www-form-urlencoded como parte do cabeçalho.
O curl exemplo a seguir faz uma solicitação de pesquisa baseada em POST sobre o tipo Observation de recurso. A solicitação usa o parâmetro de value-conceptpesquisa para procurar o código médico 266919005 que indica o valorNever smoker. Para ver o exemplo inteiro, role até o botão Copiar.
- SigV4
-
Autorização SigV4
curl --request POST \
'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation/_search' \
--aws-sigv4 'aws:amz:region:healthlake' \
--user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
--header "x-amz-security-token:$AWS_SESSION_TOKEN" \
--header "Content-Type: application/x-www-form-urlencoded"
--header "Accept: application/json"
--data @search-observation.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.
Exemplos: pesquisar com POST
As guias a seguir fornecem exemplos para pesquisar tipos específicos de recursos do FHIR com. POST Os exemplos mostram como especificar uma solicitação no URLs.
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 POST baseada no tipo de Patient recurso. O exemplo de pesquisa a seguir usa o eq comparador de pesquisa para pesquisar indivíduos nascidos em 1997.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient/_search
Para especificar o ano de 1997 na pesquisa, adicione o seguinte elemento ao corpo da solicitação.
birthdate=eq1997
- Condition
-
Use o seguinte para fazer uma POST solicitação sobre o tipo de Condition recurso. Essa pesquisa encontra locais em seu armazenamento HealthLake de dados que contêm o código médico72892002.
Você precisa especificar uma URL e um corpo da solicitação. Aqui está um exemplo de URL de solicitação.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition/_search
Para especificar o código médico que você deseja pesquisar, adicione o seguinte elemento JSON ao corpo da solicitação.
code=72892002
- DocumentReference
-
Para ver os resultados HealthLake do processamento integrado de linguagem natural (NLP) ao fazer uma POST solicitação sobre o tipo de DocumentReference recurso, formate uma solicitação da seguinte forma.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/DocumentReference/_search
Para especificar os parâmetros DocumentReference de pesquisa a serem referenciados, consulteTipos de parâmetros de pesquisa. A sequência de caracteres de consulta a seguir usa vários parâmetros de pesquisa para pesquisar as operações da API Amazon Comprehend Medical usadas para gerar os resultados integrados de PNL.
_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 POST solicitação sobre o tipo de Location recurso. A pesquisa encontra locais em seu armazenamento de HealthLake dados que contêm o nome da cidade Boston como parte do endereço.
Você deve especificar uma URL e um corpo da solicitação. Aqui está um exemplo de URL de solicitação.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location/_search
Para especificar Boston na pesquisa, adicione o seguinte elemento ao corpo da solicitação:
address=Boston
- Observation
-
Use o exemplo a seguir para fazer uma solicitação de pesquisa POST baseada no tipo de Observation recurso. A pesquisa usa o parâmetro de value-concept pesquisa para procurar o código médico, 266919005 isso indicaNever smoker.
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation/_search
Para especificar o statusNever smoker, defina value-concept=266919005 no corpo do JSON.
value-concept=266919005
