Bitácora de auditoría — BestDoctorsRD API

GET/v1/audit-logs

List audit logs with optional filters

Parámetros

Nombre	En	Tipo	Obl.
`user_id`Filter by user ID	query	string o nulo	No
`userId`Filter by user ID	query	string o nulo	No
`action`Filter by action (e.g. PATIENT_CREATED)	query	string o nulo	No
`entity_type`Filter by entity type (e.g. Patient)	query	string o nulo	No
`entityType`Filter by entity type	query	string o nulo	No
`patient_id`Filter by patient ID	query	string o nulo	No
`patientId`Filter by patient ID	query	string o nulo	No
`module`Filter by module	query	string o nulo	No
`review_status`Filter by review status	query	string o nulo	No
`reviewStatus`Filter by review status	query	string o nulo	No
`tenant_id`Filter by tenant ID (SUPER_ADMIN only)	query	string o nulo	No
`tenantId`Filter by tenant ID (SUPER_ADMIN only)	query	string o nulo	No
`user_search`Search by user full name or email	query	string o nulo	No
`userSearch`Search by user full name or email	query	string o nulo	No
`date_from`Start of date range (inclusive)	query	string (date-time) o nulo	No
`dateFrom`Start of date range (inclusive)	query	string (date-time) o nulo	No
`date_to`End of date range (inclusive)	query	string (date-time) o nulo	No
`dateTo`End of date range (inclusive)	query	string (date-time) o nulo	No
`page`Page number	query	integer	No
`page_size`Items per page	query	integer	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	AuditLogListOut
422	Error de validación	HTTPValidationError

POST/v1/audit-logs/access

Append a privacy access audit log

Cuerpo obligatorio `AuditAccessLogIn`

Campo	Tipo	Obl.
`recordType`	string	Sí
`recordId`	string	Sí
`patientId`	string o nulo	No
`module`	string	Sí
`action`	string	No
`reason`	string o nulo	No
`metadata`	object	No
`flagForReview`	boolean	No
`reviewReason`	string o nulo	No

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	AuditLogOut
422	Error de validación	HTTPValidationError

POST/v1/audit-logs/{log_id}/review

Registra la decisión sobre un registro marcado

Cierra un marcado dejando una entrada NUEVA, sin tocar la revisada. La detección automática (5 accesos sensibles en 15 minutos) funciona y no tenía cierre: los avisos se acumulaban sin que nadie pudiera decir «lo miré». Esto es el cierre.

Parámetros

Nombre	En	Tipo	Obl.
`log_id`	path	integer	Sí

Cuerpo obligatorio `AuditReviewIn`

Campo	Tipo	Obl.
`decision`	string	Sí
`reason`	string	Sí

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	AuditLogOut
422	Error de validación	HTTPValidationError

List audit logs with optional filters

Parámetros

Respuestas

Append a privacy access audit log

Cuerpo obligatorio AuditAccessLogIn

Respuestas

Registra la decisión sobre un registro marcado

Parámetros

Cuerpo obligatorio AuditReviewIn

Respuestas

Cuerpo obligatorio `AuditAccessLogIn`

Cuerpo obligatorio `AuditReviewIn`