Compartir a través de

Prueba de la API de FHIR en Azure API for FHIR

  • Artículo

Importante

Azure API for FHIR se retirará el 30 de septiembre de 2026. Siga las estrategias de migración para realizar la transición al servicio Azure Health Data Services FHIR® antes de esa fecha. Debido a la retirada de Azure API for FHIR, no se permitirán nuevas implementaciones a partir del 1 de abril de 2025. El servicio FHIR de Azure Health Data Services es la versión evolucionada de la API de Azure para FHIR que permite a los clientes administrar FHIR, DICOM y los servicios de tecnologías médicas con integraciones en otros servicios de Azure.

En el tutorial anterior, ha implementado Azure API for FHIR y ha registrado su aplicación cliente. Ya está listo para probar Azure API for FHIR.

Recuperación de la instrucción de funcionalidad

En primer lugar, se obtendrá la instrucción de funcionalidad de Azure API for FHIR.

  1. Abra Postman.
  2. Recupere la instrucción de funcionalidad mediante GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/metadata. En la imagen siguiente, el nombre del servidor de FHIR es fhirserver.

Instrucción de funcionalidad

A continuación, se intentará recuperar a un paciente. Para ello, escriba GET https://\<FHIR-SERVER-NAME>.azurehealthcareapis.com/Patient. Aparecerá el error 401 No autorizado. Este error se debe a que no ha demostrado que puede acceder a los datos del paciente.

Obtención de un paciente del servidor de FHIR

Paciente con error

Para acceder, necesita un token de acceso.

  1. En Postman, seleccione Authorization y en Type, seleccione OAuth2.0.
  2. Seleccione Obtener un token de acceso nuevo.
  3. Rellene los campos y seleccione Request Token (Solicitar token). A continuación puede ver los valores para cada campo de este tutorial.
Campo Value
Nombre del token Nombre para el token
Tipo de concesión Código de autorización
Dirección URL de devolución de llamada https://www.getpostman.com/oauth2/callback
Auth URL https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/?resource=https://<FHIR-SERVER-NAME>.azurehealthcareapis.com
URL de token de acceso https://login.microsoftonline.com/<AZURE-AD-TENANT-ID>/oauth2/token
Id. de cliente Identificador de cliente copiado en los pasos anteriores
Secreto de cliente <EN BLANCO>
Ámbito <EN BLANCO>
Valor 1234
Autenticación de cliente Enviar credenciales de cliente en el cuerpo
  1. Inicie sesión con sus credenciales y seleccione Accept (Aceptar).
  2. Desplácese hacia abajo en el resultado y seleccione Use Token (Usar token).
  3. Vuelva a seleccionar Send en la parte superior y esta vez debería obtener el resultado Paciente correcto.

Publicación de un paciente en el servidor de FHIR

Ya tiene acceso y puede crear un nuevo paciente. Este es un ejemplo de un paciente simple que puede agregar a su servidor de FHIR. Escriba esto json en la sección Body de Postman.

    {
        "resourceType": "Patient",
        "active": true,
        "name": [
            {
                "use": "official",
                "family": "Kirk",
                "given": [
                    "James",
                    "Tiberious"
                ]
            },
            {
                "use": "usual",
                "given": [
                    "Jim"
                ]
            }
        ],
        "gender": "male",
        "birthDate": "1960-12-25"
    }

En esta publicación se creará un nuevo paciente en el servidor de FHIR con el nombre James Tiberious Kirk. Publicación de un paciente

Si vuelve a ejecutar el comando GET para recuperar a un paciente, verá James Tiberious Kirk en la salida.

Nota:

Al enviar solicitudes a Azure API for FHIR, debe asegurarse de que el encabezado Content-Type es application/json

Solución de problemas de acceso

Si han surgido problemas en alguno de estos pasos, revise los documentos que hemos reunido en Microsoft Entra ID y Azure API for FHIR.

  • Microsoft Entra ID y Azure API for FHIR: en este documento se describen algunos de los principios básicos de Microsoft Entra ID y cómo interactúa con Azure API for FHIR.
  • Validación de tokens de acceso: esta guía de procedimientos proporciona detalles más específicos sobre la validación de tokens de acceso y los pasos que se deben llevar a cabo para resolver problemas de acceso.

Pasos siguientes

Ahora que ya puede conectarse correctamente a la aplicación cliente, está preparado para escribir la aplicación web.

Escribir una aplicación web

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