API de Citas y Turnos
API REST de una plataforma de citas y turnos para la gestion de citas, turnos, catalogos maestros, configuracion del sistema, empleados, banners y plantillas de correo.
La especificacion se ha generado a partir del analisis directo de rutas, controladores, modelos, migraciones y estructuras legacy presentes en el proyecto Laravel.
Autenticacion:
- Los endpoints protegidos usan tokens Bearer emitidos por Laravel Sanctum.
- El login y el registro devuelven un token plano reutilizable en la cabecera
Authorization: Bearer <token>.
Convenciones relevantes:
- Algunas operaciones legacy aceptan campos serializados como texto JSON, especialmente
assignedAppointmentType_idytypeen calendario. - Los recursos paginados siguen la estructura nativa de Laravel con
data,linksymeta. - Los listados principales cargan relaciones de dominio como
employee,type,stateytranslations.
Tags
Auth
Registro e inicio de sesion de empleados
Appointments
Reserva y gestion de citas
Shifts
Gestion de turnos sin cita previa
Types
Catalogo de tipos de cita y sus traducciones
Languages
Catalogo de idiomas y localizacion
Employees
Gestion de empleados y mesas asignadas
OverTheCounter
Gestion de mostradores o mesas
States
Estados de citas y turnos
Calendars
Dias disponibles y excepciones de agenda
Settings
Parametros generales y locales por defecto
Email Templates
Configuracion de plantillas de correo y ajustes de remitente
Options
Opciones funcionales y branding
Banners
Banners mostrados en monitor o solicitud
System
Endpoints tecnicos o de diagnostico