La API de Day Off te permite conectar tus sistemas con Day Off de forma fluida y automatizar procesos clave. Con ella, puedes acceder y gestionar datos de forma programática, como registros de empleados, solicitudes de permisos y saldos, ayudándote a reducir el trabajo manual y mantener todo sincronizado entre tus herramientas.
Pasos de configuración
1. Ve a la sección de API en Day Off
Comienza accediendo a la configuración de la API dentro de tu cuenta de Day Off.
- Desde el menú principal, ve a Integraciones
- Haz clic en API
Accederás a la página de gestión de claves API. Al principio, esta página puede aparecer vacía (como se muestra en la captura de pantalla), especialmente si aún no has creado ninguna clave API. Esto es completamente normal. Considera esta página como tu centro de control para todo lo relacionado con el acceso a la API.
2. Crear una nueva clave API.
Antes de poder conectarte a la API, necesitas generar una clave API. Esta clave actúa como una contraseña segura que permite que tu sistema se comunique con Day Off.
- Haz clic en Agregar clave API
- Aparecerá una ventana emergente
- Ingresa un nombre para tu clave: por ejemplo, «Integración con sistema de RRHH» o «Automatización con Zapier»
- Elige una fecha de vencimiento: esto añade una capa adicional de seguridad
- Haz clic en Agregar
Una vez creada, tu clave API será generada.
3. Abrir y comprender la documentación de la API
Ahora que tienes tu clave API, el siguiente paso es comprender cómo utilizarla.
- Haz clic en Documentación
- Esto abrirá la documentación de la API de Day Off
En su interior encontrarás:
- Una lista de endpoints disponibles (acciones que puedes realizar con la API)
- Ejemplos de solicitudes y respuestas
- Detalles técnicos para desarrolladores
Por ejemplo, puedes:
- Obtener una lista de empleados
- Consultar solicitudes de permisos
- Verificar saldos de permisos
- Acceder a equipos, roles y ubicaciones
También hay una opción para descargar la especificación OpenAPI, que es útil si trabajas con desarrolladores o herramientas como Postman. Considera la documentación como tu manual de instrucciones para la API.
4. Conectar usando tu clave API
Para conectar tu sistema con Day Off, deberás incluir tu clave API al enviar solicitudes.
- Añade tu clave API de la siguiente manera:
x-api-key: YOUR_API_KEY
Este paso le indica a Day Off que la solicitud proviene de ti. Si la clave está ausente o es incorrecta:
- La solicitud no funcionará
- Recibirás un error
5. Comenzar a usar la integración
Una vez que todo esté configurado, puedes comenzar a usar la API. Ahora puedes:
- Obtener información de los empleados
- Realizar un seguimiento o gestionar solicitudes de permisos
- Mantener los datos sincronizados con tus otras herramientas
Esto te ayuda a ahorrar tiempo y evitar realizar el mismo trabajo de forma manual.
Buenas prácticas (muy recomendadas)
Para mantener tu integración segura y confiable:
- Mantén tu clave API privada en todo momento
- Rota tus claves API con regularidad (crea nuevas y elimina las antiguas)
- Establece siempre una fecha de vencimiento para mayor seguridad
- Nunca expongas las claves API en aplicaciones frontend o repositorios públicos
- Consulta siempre la documentación al crear solicitudes
La API de Day Off te brinda control total y flexibilidad para conectar tus sistemas con Day Off. Aunque la configuración es sencilla, abre la puerta a una potente automatización y personalización.
Una vez que todo esté en su lugar, tu equipo podrá reducir el trabajo manual, evitar errores y mantener todos los sistemas perfectamente sincronizados.