04. API y webhooks

La API REST de Lumbre te permite leer y escribir proyectos, tareas y comentarios. Los webhooks avisan a tu aplicación cuando algo cambia.

Autenticación

Creá una clave en Ajustes → API. Enviala en el encabezado Authorization de cada pedido:

curl https://api.lumbre.example/v1/projects \
  -H "Authorization: Bearer TU_CLAVE"

Crear una tarea

const res = await fetch('https://api.lumbre.example/v1/tasks', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.LUMBRE_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    project_id: 'prj_8f2a',
    title: 'Revisar el informe de octubre',
    due_on: '2026-10-15'
  })
});
const task = await res.json();

Webhooks

Registrá una URL en Ajustes → API → Webhooks y elegí los eventos. Lumbre envía un POST con un JSON como este:

{
  "event": "task.completed",
  "task": { "id": "tsk_51c9", "title": "Revisar el informe de octubre" },
  "occurred_at": "2026-10-02T14:03:00Z"
}

Límites