API de DutyBeat
Integra los datos de tu empresa (empleados, fichajes, ausencias…) con sistemas externos —tu ERP, el software de nóminas o tus propios scripts— mediante la API pública de DutyBeat.
Antes de empezar
URL base
https://api.dutybeat.com Autenticación
Authorization: Bearer db_live_… Cada petición se autentica con una clave de API. Las creas tú desde la app en Administración → Configuración → Claves de API (necesitas rol de administrador). Cada clave solo puede llamar a los métodos que le hayas activado, y la ves una única vez al crearla. Tienes el paso a paso en Crear una clave de API.
Clientes oficiales (SDK)
Para no llamar a la API «a mano», publicamos clientes oficiales que envuelven la autenticación, los reintentos y los errores:
Python · PyPI
pip install dutybeatPowerShell · PSGallery
Install-Module dutybeatContrato completo en formato OpenAPI (importable a Postman, Insomnia o Redoc): https://api.dutybeat.com/api/v1/openapi.json .
Métodos
Identidad de la clave
/api/v1/me Leer usuario
/api/v1/users/:user_id Listar usuarios
/api/v1/users Crear usuario
/api/v1/users Editar usuario
/api/v1/users/:user_id Dar de baja usuario
/api/v1/users/:user_id/deactivate Listar fichajes
/api/v1/attendance Resumen de jornada (empresa)
/api/v1/attendance/summary Fichar (empujar marca)
/api/v1/attendance Listar ausencias
/api/v1/absences Leer ausencia
/api/v1/absences/:absence_id Crear ausencia
/api/v1/absences Aprobar o rechazar ausencia
/api/v1/absences/:absence_id/decide Leer gasto
/api/v1/expenses/:expense_id Listar tipos de ausencia
/api/v1/absence-types Listar festivos
/api/v1/holidays Listar departamentos
/api/v1/departments Listar sedes
/api/v1/work-centers Listar gastos
/api/v1/expenses Listar proyectos
/api/v1/projects Leer proyecto
/api/v1/projects/:project_id Listar imputaciones
/api/v1/allocations Imputar horas
/api/v1/allocations