La API publica de CertificAhorro -- Guia de inicio

Quien puede usar la API?

La API publica v1 esta disponible para los usuarios del plan Pro. Requiere una clave API generada desde Mi cuenta > API.

Obtener tu clave API

1. Ir a Mi cuenta > API

2. Tu clave API aparece en formato ca_live_xxxxxxxxxxxxxxxxxxxxxxxxxx

3. Guardala en un lugar seguro -- no se puede recuperar si se pierde, solo regenerar

Autenticacion

Incluye tu clave en el header de cada peticion:

```

Authorization: Bearer ca_live_xxx

```

Tu primera peticion

```bash

curl https://certificahorro.es/api/v1/expedientes \

-H "Authorization: Bearer ca_live_xxx"

```

Endpoints disponibles

| Metodo | Endpoint | Descripcion |

|---|---|---|

| GET | /expedientes | Listar expedientes |

| POST | /expedientes | Crear expediente |

| GET | /expedientes/{id} | Detalle |

| PATCH | /expedientes/{id} | Actualizar |

| POST | /expedientes/{id}/avanzar | Avanzar etapa |

| POST | /expedientes/{id}/calcular | Calcular ahorro |

| GET | /fichas | Listar fichas IDAE |

| GET | /beneficiarios | Listar beneficiarios |

Rate limiting

100 peticiones por minuto por organizacion. Headers en cada respuesta:

```

X-RateLimit-Limit: 100

X-RateLimit-Remaining: 87

X-RateLimit-Reset: 1711900800

```

Webhooks

Recibe eventos en tiempo real cuando ocurren acciones en CertificAhorro.

Eventos disponibles:

Configurar un webhook desde Mi cuenta > API > seccion Webhooks.

Documentacion completa

Disponible en Mi cuenta > API > Ver documentacion OpenAPI.