Búsqueda y paginación de pacientes

Busque recursos de pacientes FHIR R4 con parámetros compatibles y siga los enlaces de paginación del paquete proporcionados por el servidor.

Requisitos

DDFS no admite SMART en los flujos de trabajo de inicio o autorización de FHIR. Utilice un token de acceso OAuth 2.0 emitido por los dominios de identidad de OCI con los ámbitos de recursos de DDFS necesarios para la solicitud. Configure el cliente y el token siguiendo los pasos de Creación de una aplicación integrada y Referencia de autenticación de DDFS.

  • Un token de acceso OAuth con permiso de búsqueda de pacientes. Al configurar la solicitud de token y permiso de cliente, utilice ddfssystem/Patient.s para el acceso de solo búsqueda o ddfssystem/Patient.rs para el acceso de búsqueda y lectura del paciente.
  • Una inclusión inversa de Provenance requiere permiso de lectura de Provenance, como ddfssystem/Provenance.r. Una búsqueda de observación independiente requiere permiso de búsqueda de observación, como ddfssystem/Observation.s o ddfssystem/Observation.rs.
  • Origen de punto final de DDFS representado por {base}.
  • Un identificador de paciente u otro valor de filtro compatible adecuado para su flujo de trabajo.
  • Confirmación de GET {base}/api/fhir/r4/metadata de que se anuncian el paciente y los parámetros utilizados por la solicitud.

Descripción general

Este escenario utiliza el punto final de búsqueda de paciente FHIR R4 (4.0.1). Una búsqueda correcta devuelve un Bundle cuyo valor type es searchset. El soporte de búsqueda es específico de la versión, por lo que no copie los parámetros en otro recurso o versión a menos que su sentencia de capacidad los anuncie.

Las URL de búsqueda pueden contener información de salud protegida (PHI). Aplique la guía de manejo en Protect Sensitive Search Data.

Parámetros de búsqueda soportados

El punto final del paciente R4 anuncia controles comunes como _count, _total, _id, _lastUpdated, _profile y _tag. Los parámetros específicos del paciente incluyen birthdate, death-date, family, given, identifier y name.

Consulte Buscar paciente para conocer los detalles de los parámetros desplegados y los comparadores, modificadores, cadenas, inclusiones e inclusiones inversas admitidos.

Ejecutar búsquedas básicas

Buscar por familia y nombre:

GET {base}/api/fhir/r4/Patient?family=Doe&given=Jane
Accept: application/fhir+json

Buscar por token de identificador:

GET {base}/api/fhir/r4/Patient?identifier=http%3A%2F%2Fhospital.example.org%2Fmrn%7C12345
Accept: application/fhir+json

Busque un intervalo de fechas de nacimiento repitiendo el parámetro con prefijos FHIR soportados:

GET {base}/api/fhir/r4/Patient?birthdate=ge2020-01-01&birthdate=le2025-12-31
Accept: application/fhir+json

Los recursos Solicitar proveniencia que se dirigen a un paciente coincidente mediante la reversión anunciada incluyen:

GET {base}/api/fhir/r4/Patient?_id={patient_id}&_revinclude=Provenance:target
Accept: application/fhir+json

Para recuperar observaciones relacionadas, busque el punto final de observación mediante el parámetro de referencia Paciente anunciado:

GET {base}/api/fhir/r4/Observation?patient=Patient/{patient_id}
Accept: application/fhir+json

Resultados de búsqueda

Utilice _count para solicitar un tamaño de página. Tratarlo como el número máximo de coincidencias solicitado en una página, no como garantía de que cada página contenga tantas entradas.

GET {base}/api/fhir/r4/Patient?_count=50&family=Doe
Accept: application/fhir+json

Una respuesta de búsqueda puede incluir una entrada Bundle.link cuyo valor relation es next:

(application/fhir+json; excerpt)
{
  "resourceType": "Bundle",
  "type": "searchset",
  "link": [
    {
      "relation": "self",
      "url": "{base}/api/fhir/r4/Patient?_count=50&family=Doe"
    },
    {
      "relation": "next",
      "url": "{server-provided-next-url}"
    }
  ]
}

Solicite la URL next proporcionada por el servidor literalmente. No lo construya, edite sus parámetros de consulta o combínelos con parámetros de la solicitud original.

GET {server-provided-next-url}
Accept: application/fhir+json

Bundle.total es opcional. Si el flujo de trabajo necesita un total y el punto final anuncia _total, solicite el modo de total soportado y gestione una respuesta que omita Bundle.total. Utilice la presencia o ausencia del enlace next proporcionado por el servidor, en lugar de un número de página calculado, para continuar o parar la paginación.

Usar _lastUpdated

Filtre por un instante de última actualización:

GET {base}/api/fhir/r4/Patient?_lastUpdated=ge2025-01-01T00:00:00Z
Accept: application/fhir+json

Combine el filtro con la paginación:

GET {base}/api/fhir/r4/Patient?_lastUpdated=ge2025-01-01T00:00:00Z&_count=100
Accept: application/fhir+json

Notas de almacenamiento en caché de lado de cliente

No suponga que las entradas del juego de búsquedas contienen metadatos de respuesta. Utilice las cabeceras HTTP devueltas para la operación solo según lo documentado por el punto final. Para una versión de recurso específica, utilice la interacción de lectura con versiones anunciada y el ID de versión de recurso.

Errores

  • 400: la solicitud contiene un parámetro o valor con formato incorrecto o no soportado.
  • 401: Faltan credenciales o no son válidas.
  • 403: el token de acceso de OAuth es válido, pero no otorga un permiso requerido por la búsqueda, como el permiso de búsqueda del paciente o el permiso de lectura para un recurso relacionado solicitado.

Consulte Referencia de OperationOutcome para obtener orientación sobre errores con formato FHIR.

Referencias

Códigos de Estado

CódigoSignificado
200La búsqueda del paciente se completó correctamente y devolvió un paquete de conjunto de búsqueda FHIR.