Acceso a los datos del paciente
Confirmar capacidades y permisos desplegados, leer un paciente y buscar recursos clínicos relacionados.
Asumir lo que supone este escenario
Su despliegue ya tiene la configuración de identidad necesaria y su aplicación puede obtener un token de acceso de OAuth con los permisos aprobados.
El registro de la aplicación, el consentimiento, el aprovisionamiento del ámbito y la configuración específica del inquilino pueden variar según el despliegue. Confirme la configuración necesaria antes de incorporar un cliente de producción.
Requisitos
- Token de acceso aprovisionado para el flujo de trabajo deseado.
- Origen de punto final de DDFS representado por
{base}. - La superficie de API con versiones correcta para los recursos que necesita.
- Una ID. lógica del paciente o un identificador compatible que necesitan las llamadas de lectura y búsqueda.
Confirmar capacidades
Antes de realizar una solicitud de recurso, recupere CapabilityStatement del punto final de metadatos para la instancia de DDFS desplegada. En este ejemplo se utiliza FHIR R4 (4.0.1):
GET {base}/api/fhir/r4/metadata
Accept: application/fhir+json
Confirme que la declaración de funcionalidad anuncia al paciente y cada recurso, interacción y parámetro de búsqueda relacionados requeridos por el flujo de trabajo. Para un flujo de trabajo de boleta electoral4 de FHIR R6 (6.0.0-ballot4), marque GET {base}/api/fhir/r6-ballot4/metadata y mantenga todas las solicitudes de recursos en esa superficie de la API.
Permisos de plan
Otorgue solo los permisos de lectura necesarios para el flujo de trabajo. Un flujo de trabajo de acceso de paciente puede requerir lecturas de Paciente, Observación, Condición o Procedencia, dependiendo de los recursos que la aplicación realmente solicite.
Consulte Referencia de autenticación de DDFS y la Matriz de ámbito de OAuth de DDFS.
Llamada a la API de FHIR
Recupere el paciente actual por ID. lógica:
curl -sS \
-H "Accept: application/fhir+json" \
-H "Authorization: Bearer {access-token}" \
"{base}/api/fhir/r4/Patient/{rid}"
Buscar observaciones para el paciente:
curl -sS \
-H "Accept: application/fhir+json" \
-H "Authorization: Bearer {access-token}" \
"{base}/api/fhir/r4/Observation?patient=Patient/{patient-id}"
Condiciones de búsqueda del paciente:
curl -sS \
-H "Accept: application/fhir+json" \
-H "Authorization: Bearer {access-token}" \
"{base}/api/fhir/r4/Condition?patient=Patient/{patient-id}"
Buscar recursos de proveniencia por destino:
curl -sS \
-H "Accept: application/fhir+json" \
-H "Authorization: Bearer {access-token}" \
"{base}/api/fhir/r4/Provenance?target=Patient/{patient-id}"
Las URL de búsqueda de FHIR pueden contener identificadores confidenciales y PHI. Consulte Protección de datos de búsqueda confidenciales antes de activar el registro de solicitudes o compartir diagnósticos.
Validar los recursos devueltos
- Valide cada recurso con la versión de FHIR y los perfiles requeridos por su aplicación o acuerdo de intercambio.
- No infiera una garantía de perfil de este escenario. Inspeccione
meta.profilecuando esté presente y valídelo según los requisitos del flujo de trabajo. - Manejar errores con formato FHIR como recursos
OperationOutcome. Consulte Referencia de OperationOutcome.
Solución de problemas
401 Unauthorized: compruebe la validez del token, el público y la configuración de despliegue.403 Forbidden: compruebe que el token otorga el permiso necesario para el recurso solicitado.400 Bad Request: compruebe el nombre del parámetro, la sintaxis del valor, el prefijo de fecha y la referencia de recurso.
Para obtener más información, consulte Solución de problemas y Preguntas frecuentes.