Acceso a Azure Health Data Services mediante la extensión de cliente REST en Visual Studio Code

En este artículo, aprenderá a acceder a Azure Health Data Services mediante la extensión de cliente REST en Visual Studio Code.

Instalación de la extensión de cliente REST

Seleccione el icono Extensiones en el panel izquierdo de Visual Studio Code y busque "Cliente REST". Busque la extensión de cliente REST e instale.

REST Client VSCode extension

Creación de un .http archivo y definición de variables

Cree un nuevo archivo en Visual Studio Code. Escriba una GET línea de comandos de solicitud en el archivo y guárdela como test.http. El sufijo .http de archivo activa automáticamente el entorno de cliente REST. Seleccione Send Request esta opción para obtener los metadatos.

Send Request

Obtención de valores de aplicación cliente

Importante

Antes de llamar a la API REST del servidor FHIR (que no sea obtener los metadatos), debe completar el registro de la aplicación. Anote el identificador de inquilino de Azure, el identificador de cliente, el secreto de cliente y la dirección URL del servicio.

Aunque puede usar valores como el identificador de cliente directamente en llamadas a la API REST, se recomienda definir algunas variables para estos valores y usar las variables en su lugar.

En su test.http archivo, incluya la siguiente información obtenida al registrar la aplicación:

### REST Client
@fhirurl =https://xxx.azurehealthcareapis.com
@clientid =xxx....
@clientsecret =xxx....
@tenantid =xxx....

Obtención del token de acceso de Microsoft Entra

Después de incluir la información siguiente en el test.http archivo, presione Send Request. Verá una respuesta HTTP que contiene el token de acceso.

La línea que comienza con @name contiene una variable que captura la respuesta HTTP que contiene el token de acceso. La variable , @token, se usa para almacenar el token de acceso.

Nota:

de grant_type se usa para obtener un token de client_credentials acceso.

### Get access token 
# @name getAADToken 
POST https://login.microsoftonline.com/{{tenantid}}/oauth2/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&resource={{fhirurl}}
&client_id={{clientid}}
&client_secret={{clientsecret}}

### Extract access token from getAADToken request
@token = {{getAADToken.response.body.access_token}}

Get access token

Nota:

En los escenarios en los que el parámetro de audiencia del servicio FHIR no está asignado a la dirección URL del punto de conexión de servicio de FHIR. El valor del parámetro de recurso debe asignarse al valor audiencia en la hoja Autenticación del servicio FHIR.

GET Datos de pacientes de FHIR

Ahora puede obtener una lista de pacientes o un paciente específico con la GET solicitud. La línea con Authorization es la información de encabezado de la GET solicitud. También puede enviar PUT o solicitudes para crear o POST actualizar recursos de FHIR.

### GET Patient 
GET {{fhirurl}}/Patient/<patientid>
Authorization: Bearer {{token}}

GET Patient

Ejecución de PowerShell o la CLI

Puede ejecutar scripts de PowerShell o la CLI en Visual Studio Code. Presione CTRL y la ~ tecla y seleccione PowerShell o Bash. Puede encontrar más detalles en Terminal integrado.

PowerShell en Visual Studio Code

running PowerShell

CLI en Visual Studio Code

running CLI

Solucionar problemas

Si no puede obtener los metadatos, lo que no requiere el token de acceso en función de la especificación HL7, compruebe que el servidor FHIR se está ejecutando correctamente.

Si no puede obtener un token de acceso, asegúrese de que la aplicación cliente está registrada correctamente y que usa los valores correctos del paso de registro de la aplicación.

Si no puede obtener datos del servidor FHIR, asegúrese de que a la aplicación cliente (o a la entidad de servicio) se le han concedido permisos de acceso como "Colaborador de datos FHIR" al servidor FHIR.

Pasos siguientes

En este artículo, ha aprendido a acceder a los datos de Azure Health Data Services mediante el uso de la extensión de cliente REST en Visual Studio Code.

Para más información sobre cómo validar los recursos de FHIR en perfiles de Azure Health Data Services, consulte

FHIR® es una marca registrada de HL7 y se usa con su permiso.