Buscar en AllergyIntolerance
Busque AllergyIntolerance mediante FHIR R4 4.0.1.
Recurso category: AllergyIntolerance.
Punto final
| Método | Punto final |
|---|---|
GET | /api/fhir/r4/AllergyIntolerance |
POST | /api/fhir/r4/AllergyIntolerance/_search |
Utilice la URL base R4 de la instancia de DDFS. Envíe Authorization: Bearer <access-token> y acepte application/fhir+json.
GET utiliza parámetros de consulta. La búsqueda POST utiliza los mismos parámetros soportados en un cuerpo application/x-www-form-urlencoded y necesita el mismo permiso de búsqueda. Siga la URL Bundle.link proporcionada por el servidor con la relación next sin cambios. Consulte controles de búsqueda compartida.
Parámetros
| Parámetro | Ubicación | Necesario | Tipo | Descripción |
|---|---|---|---|---|
identifier | Cuerpo de la pantalla o consulta | Nº | token | Identificadores de nivel superior, con valor, system|value, |value o system|. Se admite un token no modificado. URI de parámetro canónico: http://hl7.org/fhir/SearchParameter/clinical-identifier. |
_count | Cuerpo de la pantalla o consulta | Nº | número | Limitar el número de coincidencias devueltas por página. Consulte los controles de búsqueda compartida para ver los valores soportados y el comportamiento de solo recuento. |
_total | Cuerpo de la pantalla o consulta | Nº | token | La solicitud admite la manipulación total; el nombre de control no implica compatibilidad con todos los modos totales de FHIR. |
_id | Consulta o cuerpo del formulario | No | token | Filtrar por ID de recurso lógico. URI de parámetro canónico: http://hl7.org/fhir/SearchParameter/Resource-id. |
_lastUpdated | Cuerpo de consulta o formulario | No | date | Filtre por _lastUpdated mediante la semántica de búsqueda date soportada. Definición: ddfs-r4-last-updated-date.json. |
_profile | Cuerpo de la pantalla o consulta | Nº | URI | Filtrar por URI de perfil. URI de parámetro canónico: http://hl7.org/fhir/SearchParameter/Resource-profile. |
_tag | Consulta o cuerpo del formulario | Nº | token | Filtrar por una etiqueta de metadatos de recurso. URI de parámetro canónico: http://hl7.org/fhir/SearchParameter/Resource-tag. |
category | Cuerpo de la pantalla o consulta | No | token | alimentos, medication, medio ambiente o biológicos. URI de parámetro canónico: http://hl7.org/fhir/SearchParameter/AllergyIntolerance-category. |
clinical-status | Cuerpo de la pantalla o consulta | Nº | token | Codificado clinicalStatus, como active, inactive o resuelto. URI de parámetro canónico: http://hl7.org/fhir/SearchParameter/AllergyIntolerance-clinical-status. |
code | Cuerpo de la pantalla o consulta | No | token | Codificaciones en code o reaction.substance. URI de parámetro canónico: http://hl7.org/fhir/SearchParameter/clinical-code. |
patient | Consulta o cuerpo del formulario | Nº | reference | Referencia del paciente; se admite el modificador :identifier existente. Definición: ddfs-r4-patient-reference-identifier-modifier.json. |
verification-status | Cuerpo de la pantalla o consulta | Nº | token | Codificado verificationStatus, como confirmado o introducido en el error. Es independiente del estado clínico. URI de parámetro canónico: http://hl7.org/fhir/SearchParameter/AllergyIntolerance-verification-status. |
_revinclude | Cuerpo de la pantalla o consulta | Nº | especial | Valores permitidos: Provenance:target. El permiso de lectura de proveniencia coincidente también es necesario. |
Autorización
| Contexto | Ámbito de recurso |
|---|---|
| Definición de servidor de recursos/token emitido | system/AllergyIntolerance.s |
| Solicitud de token/otorgamiento de cliente | ddfssystem/AllergyIntolerance.s |
Se siguen aplicando restricciones de recursos. Utilice el privilegio mínimo necesario para esta operación; consulte authentication and scope configuration.
Comportamiento
Devolver recursos AllergyIntolerance coincidentes en un paquete searchset. Los filtros y las restricciones del emisor de llamada determinan qué coincidencias se pueden devolver. No infiera modificadores, cadenas, valores repetidos o modos de control de resultados no admitidos de la especificación FHIR base.
- Comportamiento de búsqueda compartida: semántica de operación compartida.
- Orientación para los recursos AllergyIntolerance: requisitos y restricciones específicos de los recursos.
- R4 CapabilityStatement y metadatos R4: capacidades soportadas.
Ejemplo de solicitud
Sustituya los ID lógicos de ejemplo, los ID de versión y los valores de conexión por valores para el flujo de trabajo.
GET /api/fhir/r4/AllergyIntolerance?patient=Patient/patient-438&code=91936005&category=medication&clinical-status=active&verification-status=confirmed&_lastUpdated=ge2026-01-01&_lastUpdated=lt2027-01-01
Respuestas
| Estado correcto | Significado |
|---|---|
| 200 | Un paquete de searchset. |
Para conocer los estados de error comunes y los cuerpos de error con formato FHIR, consulte OperationOutcome errors. Las respuestas de autenticación/autorización siguen la política compartida; un recurso protegido se puede ocultar como 404. Consulte también respuestas de interacción.
Definición de FHIR
Definición de FHIR R4: https://hl7.org/fhir/R4/allergyintolerance.html. Perfil canónico URI: http://hl7.org/fhir/StructureDefinition/AllergyIntolerance.