Historia clínica — BestDoctorsRD API

POST/v1/clinical-notes

Create Clinical Note

Parámetros

Nombre	En	Tipo	Obl.
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `ClinicalNoteCreateIn`

Campo	Tipo	Obl.
`patientId`	string	Sí
`doctorId`	string o nulo	No
`appointmentId`	string o nulo	No
`admissionId`	string o nulo	No
`noteType`	string	No
`subjective`	string o nulo	No
`objective`	string o nulo	No
`assessment`	string o nulo	No
`plan`	string o nulo	No
`body`	string o nulo	No

Respuestas

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

GET/v1/clinical-notes/{note_id}

Get Clinical Note

Parámetros

Nombre	En	Tipo	Obl.
`note_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

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

PATCH/v1/clinical-notes/{note_id}

Update Clinical Note

Corrige el contenido de una nota clínica NO firmada — PRD #931 / CR-249. La política de integridad necesita una vía de edición GOBERNADA para la nota (sin ella, la reapertura no tendría propósito y las correcciones seguirían ocurriendo fuera de la API, que es justo la invalidación silenciosa que el CR persigue). El guard es el mismo de la firma (médico tratante dueño de la nota) y toda edición queda auditada; si la nota está firmada, se rechaza con 409 ``DOCUMENT_SIGNED``.

Parámetros

Nombre	En	Tipo	Obl.
`note_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `ClinicalNoteUpdateIn`

Campo	Tipo	Obl.
`noteType`	string o nulo	No
`subjective`	string o nulo	No
`objective`	string o nulo	No
`assessment`	string o nulo	No
`plan`	string o nulo	No
`body`	string o nulo	No

Respuestas

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

POST/v1/clinical-notes/{note_id}/cosign

Cosign Clinical Note

Parámetros

Nombre	En	Tipo	Obl.
`note_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

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

POST/v1/clinical-notes/{note_id}/reopen

Reopen Clinical Note Signature

Reapertura EXPLÍCITA y auditada de una nota clínica firmada — PRD #931 / CR-249. Es la única vía para corregir el contenido firmado: invalida la firma primaria y la co-firma exigiendo un MOTIVO, lo deja auditado (``CLINICAL_NOTE_SIGNATURE_REOPENED``, con la firma anulada en el metadata) y devuelve la nota a estado editable. Después hay que volver a firmarla (y a pedir co-firma si aplica).

Parámetros

Nombre	En	Tipo	Obl.
`note_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `ReopenClinicalNoteIn`

Campo	Tipo	Obl.
`reason`	string	Sí

Respuestas

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

POST/v1/clinical-notes/{note_id}/sign

Sign Clinical Note

Parámetros

Nombre	En	Tipo	Obl.
`note_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo opcional `SignClinicalNoteIn o nulo`

Respuestas

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

GET/v1/clinical-notes/{note_id}/signature

Get Clinical Note Signature

Parámetros

Nombre	En	Tipo	Obl.
`note_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

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

GET/v1/patients/{patient_id}/clinical-notes

List Patient Clinical Notes

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`page`	query	integer	No
`page_size`	query	integer	No
`tenant_id`	query	string o nulo	No

Respuestas

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

GET/v1/patients/{patient_id}/vital-signs

List Patient Vital Signs

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`page`	query	integer	No
`page_size`	query	integer	No
`tenant_id`	query	string o nulo	No

Respuestas

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

POST/v1/patients/{patient_id}/vital-signs

Create Vital Sign

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `VitalSignCreateIn`

Campo	Tipo	Obl.
`takenAt`	string (date-time) o nulo	No
`weightKg`	number o nulo	No
`heightCm`	number o nulo	No
`bmi`	number o nulo	No
`temperatureC`	number o nulo	No
`bloodPressureSystolic`	integer o nulo	No
`bloodPressureDiastolic`	integer o nulo	No
`heartRate`	integer o nulo	No
`respiratoryRate`	integer o nulo	No
`spo2`	integer o nulo	No
`glucoseMgDl`	number o nulo	No
`painScale`	integer o nulo	No

Respuestas

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

Create Clinical Note

Parámetros

Cuerpo obligatorio ClinicalNoteCreateIn

Respuestas

Get Clinical Note

Parámetros

Respuestas

Update Clinical Note

Parámetros

Cuerpo obligatorio ClinicalNoteUpdateIn

Respuestas

Cosign Clinical Note

Parámetros

Respuestas

Reopen Clinical Note Signature

Parámetros

Cuerpo obligatorio ReopenClinicalNoteIn

Respuestas

Sign Clinical Note

Parámetros

Cuerpo opcional SignClinicalNoteIn o nulo

Respuestas

Get Clinical Note Signature

Parámetros

Respuestas

List Patient Clinical Notes

Parámetros

Respuestas

List Patient Vital Signs

Parámetros

Respuestas

Create Vital Sign

Parámetros

Cuerpo obligatorio VitalSignCreateIn

Respuestas

Cuerpo obligatorio `ClinicalNoteCreateIn`

Cuerpo obligatorio `ClinicalNoteUpdateIn`

Cuerpo obligatorio `ReopenClinicalNoteIn`

Cuerpo opcional `SignClinicalNoteIn o nulo`

Cuerpo obligatorio `VitalSignCreateIn`