> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coupons.piixan.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cambios

> Historial de versiones de la API de datos.

## 2026-09-25

* `resultado_url` de un lote (en el estado y en el webhook `lote.completado`) puede ser
  una **URL firmada de 60 minutos** para descargar el JSONL directamente del almacén de
  objetos; `GET /v1/lotes-decision/{job_id}/resultado` sigue funcionando igual.
* `en_sombra` en la respuesta de decisión y guía «Modo sombra» (cómo integrar
  mientras el motor solo sugiere). Campo opcional: los clientes existentes no cambian.
* Todas las operaciones documentan las respuestas de error 401, 403, 422 y 429 con el
  cuerpo uniforme `ErrorV1` y `Retry-After`.

## v1 (en construcción)

* Eventos: seis tipos, lotes de hasta 1.000, idempotencia por `event_id`.
* Decisiones en línea con `Idempotency-Key`, confirmación de ejecución, respaldo.
* Lotes por campaña con resultado JSONL y webhook `lote.completado` firmado.
* Catálogo de acciones y campañas con presupuesto.
* Clientes: exportación y borrado (derechos ARCO).

La versión v1 se mantiene estable; los cambios incompatibles llegarán como v2 y
ambas coexistirán.