Primeros pasos

Esta API expone la base funcional de Gesturcit: autenticacion de empleados, citas, turnos, catalogos maestros, configuracion y elementos de branding operacional.

Flujo recomendado

1. Revisa la guia de autenticacion.
2. Obtén un token Bearer mediante POST /auth/login.
3. Configura tu cliente HTTP con Authorization: Bearer <token>.
4. Empieza por recursos troncales como /appointments, /shifts, /types o /settings.

Base URL

La especificacion actual incluye entornos locales:

Code
http://localhost:8000/api
http://127.0.0.1:8000/api

Convenciones importantes

• Los endpoints protegidos usan Laravel Sanctum.
• Algunos campos legacy aceptan JSON serializado como texto.
• Los listados paginados siguen la estructura nativa de Laravel con data, links y meta.
• Parte de los recursos devuelven relaciones enriquecidas como employee, type, state o translations.

Dominios funcionales principales

• Auth: login y registro de empleados.
• Appointments: reserva, disponibilidad y operativa de citas.
• Shifts: turnos sin cita previa.
• Calendars: huecos, dias operativos y excepciones.
• Employees, OverTheCounter, States: recursos de operacion presencial.
• Settings, Options, Banners, Email Templates: configuracion funcional y visual.

Siguiente paso

Abre la referencia API para probar endpoints y revisar esquemas de request y response.