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.
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.
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}}
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}}
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
CLI en Visual Studio Code
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.