4 operaciones · base https://api.bestdoctorsrd.com
GET/v1/work-shifts
Turnos de trabajo del centro
Los del CENTRO que pregunta. Un turno de otro centro no se ve ni existe para esta ruta.
Por defecto vienen TODOS, incluidos los desactivados: quien lee un rol ya hecho necesita
resolver la etiqueta de un turno retirado, y sin él se quedaría con el código crudo en pantalla.
Con `includeInactive=false` vienen sólo los que se pueden ofrecer en asignaciones nuevas.
Parámetros
Nombre
En
Tipo
Obl.
status
query
string o nulo
No
includeInactive
query
boolean
No
tenant_id
query
string o nulo
No
Respuestas
Código
Descripción
Devuelve
200
Respuesta correcta
lista de WorkShiftOut
422
Error de validación
HTTPValidationError
POST/v1/work-shifts
Crear un turno
Parámetros
Nombre
En
Tipo
Obl.
tenant_id
query
string o nulo
No
Cuerpo obligatorioWorkShiftCreateIn
Campo
Tipo
Obl.
name
string
Sí
code
string
Sí
startTime
string
Sí
endTime
string
Sí
color
string o nulo
No
Respuestas
Código
Descripción
Devuelve
201
Respuesta correcta
WorkShiftOut
422
Error de validación
HTTPValidationError
GET/v1/work-shifts/colores
Paleta de colores del turno
La paleta cerrada, para que la pantalla ofrezca exactamente lo que la puerta acepta.
Hoy no hay ningún `GET /{shift_id}` con el que competir —el único camino variable es un
PATCH, y FastAPI no confunde métodos distintos—. El día que se añada el detalle, esta ruta
tiene que quedar POR ENCIMA: FastAPI resuelve por orden de declaración y `/colores` se
tragaría el `shift_id`.
Parámetros
Nombre
En
Tipo
Obl.
tenant_id
query
string o nulo
No
Respuestas
Código
Descripción
Devuelve
200
Respuesta correcta
lista de ShiftColorOut
422
Error de validación
HTTPValidationError
PATCH/v1/work-shifts/{shift_id}
Editar o desactivar un turno
Edita el turno, y lo DESACTIVA cuando llega `status = INACTIVE`.
No hay borrado y no es un olvido: del turno cuelgan las filas del rol ya hechas y tienen que
seguir resolviendo su etiqueta. Desactivado deja de ofrecerse para asignaciones nuevas y
conserva el historial.
Cambiar el horario tampoco reescribe nada: la fila del rol se lleva su propia copia del horario
(decisión del PRD-1831), así que corregir «Noche» en septiembre no altera lo que se trabajó en
agosto.