Escenario: Buscar en el directorio PractitionerRole
Busque recursos de FHIR R4 PractitionerRole con los parámetros de referencia, cadena, especialidad, inclusión y fecha anunciados.
Autorización
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 obtenga tokens siguiendo Crear una aplicación integrada y Referencia de autenticación de DDFS.
Parámetros de Búsqueda
La superficie de búsqueda de R4 PractitionerRole anuncia practitioner y specialty, además de _id, _lastUpdated, _profile, _tag, _count y _total. Consulte GET /api/fhir/r4/PractitionerRole para conocer las definiciones de parámetros exactas.
Búsqueda por practicante
Utilice una referencia directa, el modificador :identifier o una de las dos cadenas anunciadas:
GET {base}/api/fhir/r4/PractitionerRole?practitioner=Practitioner/{practitioner_id}
GET {base}/api/fhir/r4/PractitionerRole?practitioner:identifier={system}|{value}
GET {base}/api/fhir/r4/PractitionerRole?practitioner.identifier={system}|{value}
GET {base}/api/fhir/r4/PractitionerRole?practitioner.name={name}
Las cadenas de profesionales anunciadas son exactamente identifier y name.
Buscar por especialidad
Utilice un valor de token para el parámetro specialty anunciado:
GET {base}/api/fhir/r4/PractitionerRole?specialty={system}|{code}
Incluir recursos de referencia
El contrato R4 PractitionerRole anuncia exactamente dos valores de inclusión:
PractitionerRole:practitionerPractitionerRole:endpoint
GET {base}/api/fhir/r4/PractitionerRole?practitioner=Practitioner/{practitioner_id}&_include=PractitionerRole:practitioner
GET {base}/api/fhir/r4/PractitionerRole?_id={role_id}&_include=PractitionerRole:endpoint
Buscar por última actualización
El parámetro _lastUpdated acepta los comparadores de fechas anunciados. Un rango puede utilizar un máximo de dos parámetros repetidos. No combine valores de fecha con una coma.
GET {base}/api/fhir/r4/PractitionerRole?_lastUpdated=ge2026-01-01T00:00:00Z&_lastUpdated=le2026-01-31T23:59:59Z
Utilice el parámetro _count anunciado al solicitar un tamaño de página.