> ## Content Index
> Fetch the complete content index at: https://faro-es.planethemes.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# 04. API y webhooks
- URL: https://faro-es.planethemes.com/api-y-webhooks/
- Published: 2026-09-21T13:00:00.000Z
- Updated: 2026-09-26T15:30:00.000Z
- Description: Armá tus propias integraciones con la API REST.
- Author: Equipo Faro
- Tags: 04. Integraciones, #Import 2026-10-02 10:36

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:

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

🔒

Tratá las claves de la API como contraseñas. Nunca las pongas en código del navegador ni en repositorios públicos.

## Crear una tarea

```javascript
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:

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

### Límites

| Plan    | Pedidos por minuto |
| ------- | ------------------ |
| Gratis  | 60                 |
| Equipo  | 300                |
| Empresa | 1.000              |