Usa la API REST

La API REST permite que tus propios sistemas hablen con Bueggio HR: leer personas, departamentos, ausencias y saldos, ver quién está fuera, simular una reserva antes de crearla y — con una clave de lectura y escritura — reservar, aprobar, rechazar o cancelar, con cada acción auditada. Es el mismo motor de la app, expuesto como JSON limpio.

Crea una clave API

Las claves las gestionan los admins y pertenecen a la organización, no a una persona:

1. Ve a Ajustes → Integraciones → API.
2. Dale a la clave un nombre que diga dónde se usará ("Zapier", "Exportación de nóminas"…).
3. Elige los permisos: Solo lectura o Lectura y escritura. Empieza con solo lectura salvo que sepas que vas a escribir.
4. Haz clic en Crear clave y cópiala inmediatamente — se muestra una sola vez y se guarda solo como hash. Si la pierdes, revócala y crea una nueva.

Tu primera petición

Autentica cada llamada con la clave como token Bearer:

curl https://www.bueggiohr.eu/api/v1/whos_off \
  --header "Authorization: Bearer bhr_..."

Tres sitios para conocer la superficie:

• Documentación de la API — la referencia legible de cada endpoint.
• /api/v1/openapi.json — la especificación OpenAPI, para generar clientes y herramientas de prueba.
• /api/docs.md — toda la referencia en un único archivo Markdown, cómodo para pegarlo a un asistente de IA.

Qué hay en la API

• Lectura — organización, personas, departamentos, tipos de ausencia, festivos, ausencias, saldos por persona, quién está fuera en un rango de fechas.
• Presupuesto — el ensayo general de una reserva: cuántos días descontaría y los conflictos que habría, sin crear nada.
• Escritura (permisos de lectura y escritura) — crear solicitudes, aprobar, rechazar, cancelar. Las reservas siguen las mismas reglas que la app: flujos de aprobación, bloqueos de fechas y topes de ausencia se aplican, y todo queda en el historial de la solicitud.
• Gestión de webhooks — registrar y quitar endpoints de webhook por programa.

Mantén las claves a salvo

• Trata una clave como una contraseña: da acceso a los datos de ausencias de toda tu organización.
• Usa una clave por sistema, con nombre claro — la lista muestra el último uso de cada clave, así las que sobran se detectan y revocan enseguida.
• Revoca de inmediato si una clave se filtra; las integraciones que la usan dejan de funcionar en ese mismo instante.

Solución de problemas

• 401 invalid_api_key — la cabecera debe ser exactamente Authorization: Bearer bhr_...; comprueba que la clave no fue revocada.
• 403 en una escritura — la clave es de solo lectura; crea una de lectura y escritura.
• Una reserva es rechazada — la API aplica las mismas reglas que la app (bloqueos de fechas, topes de ausencia, saldos). El mensaje de error dice qué regla la rechazó.