Búsqueda de recursos del FHIR con GET - AWS HealthLake
Ejemplos de búsqueda GET

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Búsqueda de recursos del FHIR con GET

Puede utilizar GET las solicitudes para buscar en un banco HealthLake de datos. Cuando se usaGET, HealthLake permite proporcionar parámetros de búsqueda como parte de la URL, pero no como parte del cuerpo de la solicitud. Para obtener más información, consulte Parámetros de búsqueda FHIR R4 para HealthLake.

Importante

Para las búsquedas que incluyen información de identificación personal (PII) o información de salud protegida (PHI), las mejores prácticas de seguridad recomiendan utilizar POST solicitudes, ya que la PII y la PHI se añaden como parte del cuerpo de la solicitud y se cifran en tránsito. Para obtener más información, consulte Búsqueda de recursos del FHIR con POST.

El siguiente procedimiento va seguido de ejemplos que se utilizan GET para buscar en un almacén de HealthLake datos.

Para buscar en un HealthLake banco de datos con GET

  1. Recopilar HealthLake region y datastoreId valorar. Para obtener más información, consulte Obtención de propiedades de los almacenes de datos.

  2. Determine el tipo de recurso del FHIR para buscar y recopilar el id valor asociado. Para obtener más información, consulte Tipos de recurso.

  3. Cree una URL para la solicitud utilizando los valores recopilados para HealthLake region ydatastoreId. Incluya también el Resource tipo de FHIR y los parámetros de búsqueda compatibles. Para ver la ruta URL completa en el siguiente ejemplo, desplázate sobre el botón Copiar.

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

  4. Envíe la GET solicitud con la versión 4 de AWS Signature o SMART con la autorización del FHIR. El siguiente curl ejemplo devuelve el número total de Patient recursos de un almacén de HealthLake datos. Para ver el ejemplo completo, desplácese sobre el botón Copiar.

    SigV4

    Autorización 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

    Ejemplo de autorización SMART on FHIR para el tipo de IdentityProviderConfigurationdatos.

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

    La persona que llama puede asignar permisos en la lambda de autorización. Para obtener más información, consulte OAuth osciloscopios 2.0.

    AWS Console
    nota

    La HealthLake consola solo admite la autorización SiGv4. La autorización SMART on FHIR se admite mediante AWS CLI y. AWS SDKs

    1. Inicie sesión en la página Ejecutar consultas de la HealthLake consola.

    2. En la sección de configuración de consultas, realice las siguientes selecciones.

    • ID de almacén de datos: elija un ID de almacén de datos para generar una cadena de consulta.

    • Tipo de consulta: elijaSearch with GET.

    • Tipo de recurso: elija el tipo de recurso del FHIR en el que desea buscar.

    • Parámetros de búsqueda: seleccione un parámetro de búsqueda o una combinación de parámetros de búsqueda para centrar la consulta en registros específicos.

    3. Elija Ejecutar consulta.

Ejemplos: busque con GET

Las siguientes pestañas proporcionan ejemplos para buscar tipos de recursos específicos del FHIR con. GET Los ejemplos muestran cómo especificar los parámetros de búsqueda en la solicitud URLs.

nota

La HealthLake consola solo admite la autorización SiGv4. La autorización SMART on FHIR se admite mediante AWS CLI y. AWS SDKs

HealthLake admite un subconjunto de parámetros de búsqueda del FHIR R4. Para obtener más información, consulte Parámetros de búsqueda.

Patient (age)

Si bien la edad no es un tipo de recurso definido en el FHIR, se captura como un elemento del tipo de recurso. Patient Utilice el siguiente ejemplo para realizar una solicitud de búsqueda GET basada en tipos de Patientrecursos mediante el elemento BirthDate y el comparador de eq búsquedas para buscar personas nacidas en el año 1997.

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

Utilice el siguiente ejemplo para realizar una GET solicitud sobre el tipo de Conditionrecurso. La búsqueda busca condiciones en el almacén de HealthLake datos que contienen el código médico de SNOMED72892002, que se traduce como. Normal pregnancy

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

En el siguiente ejemplo, se muestra cómo crear una GET solicitud sobre el tipo de DocumentReferencerecurso para Patient personas con diagnóstico de estreptococos y a quienes también se les ha recetado 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

Utilice el siguiente ejemplo para realizar una solicitud sobre el tipo de recursoGET. Location La siguiente búsqueda busca ubicaciones en el banco de HealthLake datos que contienen el nombre de la ciudad Boston como parte de la dirección.

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

Utilice el siguiente ejemplo para realizar una solicitud de búsqueda GET basada en el tipo Observationde recurso. Esta búsqueda utiliza el parámetro value-concept de búsqueda para buscar el código médico266919005, que se traduce comoNever smoker.

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