Crear una clave de API
Crea y gestiona las claves que dan acceso a la API de DutyBeat.
DutyBeat tiene una API pública para integrar tus datos (empleados, fichajes, ausencias…) con sistemas externos: tu ERP, el software de nóminas o tus propios scripts. El acceso se controla con claves de API que creas y gestionas tú desde aquí.
Crear una clave
En Administración → Configuración → Claves de API (solo administradores):
- Ponle un nombre que identifique para qué es (por ejemplo, «Integración Nómina»).
- Activa, con los interruptores, los métodos que esa clave podrá usar. Se activan uno a uno: una clave puede tener varios métodos, y conceder uno no concede los demás.
- Pulsa Crear clave. La clave (empieza por
db_live_…) se muestra una sola vez: cópiala y guárdala en un lugar seguro. No podrás volver a verla.
Trata cada clave como una contraseña. Si una clave se compromete o deja de usarse, revócala con la papelera de su fila; al revocarla desaparece de la lista y deja de funcionar al instante.
Usar la API
La referencia completa para desarrolladores —cada método con sus parámetros y ejemplos en cURL, Python y PowerShell, más los SDKs oficiales— está en la sección API del manual.
Límite de peticiones
Cada clave puede hacer hasta 300 peticiones por minuto. Al superarlo la API responde con el código
429 e indica en la cabecera Retry-After cuántos segundos hay que esperar. Los SDKs oficiales de
Python y PowerShell reintentan solos respetando ese aviso, así que no tienes que programar nada. Si
prevés una carga puntual mayor (una importación masiva, por ejemplo), avísanos antes de lanzarla.