Documentación de la API

Conectando y Trabajando con la API de Shifton

La API de Shifton te da acceso a todas las funciones clave de la plataforma, desde la gestión de horarios hasta integraciones con RRHH, nómina, y sistemas de análisis.
Al usar la API, puedes automatizar procesos y conectar Shifton con los servicios internos de tu empresa.

Documentación de la API

Soportamos dos versiones de nuestra documentación:

• 📄 Documentación Antigua — la versión anterior de la referencia de la API (todavía compatible para integraciones existentes):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Documentación Nueva — la versión actual de la API con una estructura actualizada y los métodos más recientes:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Empezando

Obtener una Clave API

En la configuración de tu empresa en la plataforma Shifton, genera una clave API.
La autorización se realiza a través del encabezado:

Haz Tu Primera Solicitud

Por ejemplo, para recuperar una lista de empleados:

Respuesta de ejemplo:

Integra la API en Tus Flujos de Trabajo

• Crear y modificar turnos automáticamente

• Gestionar solicitudes de vacaciones y baja por enfermedad

• Exportar datos a sistemas de nómina

• Construir tableros de control e informes personalizados

Capacidades del API central

• Empleados – añadir, editar y gestionar roles

• Horarios – crear, ajustar turnos, planificar trabajo

• Tiempo Libre & Ausencias – gestionar solicitudes de vacaciones y bajas por enfermedad

• Informes – exportar datos de tiempo, nómina y asistencia

Códigos de Error

El API de Shifton utiliza códigos de estado HTTP:

• 200 — Solicitud exitosa

• 201 — Objeto creado exitosamente

• 400 — Parámetros inválidos

• 401 — Error de autorización (clave de API inválida)

• 403 — Acceso denegado

• 404 — Recurso no encontrado

• 500 — Error del servidor

Consejos de Uso

• Siempre use la nueva versión del API para nuevas integraciones

• Use Postman o curl para pruebas

• Respeta los límites de tasa para evitar ser bloqueado

• Actualiza las integraciones que aún dependen de la documentación antigua