Changelog de la API

Cambios visibles para integradores en /api/v1 y en los webhooks salientes, del más reciente al más antiguo. Las reglas para cambios y retiradas están en la política de versiones y deprecación.

Cada entrada lleva una etiqueta: Añadido (nuevo, compatible), Cambiado (comportamiento distinto, sin romper contrato), Corregido o Deprecado (con fecha de retirada).

2026-11

Fecha	Tipo	Cambio
2026-11-02	Añadido	Trabajos masivos asíncronos: POST /api/v1/jobs/import y POST /api/v1/jobs/export (recurso members, Idempotency-Key obligatoria, límites de tamaño), GET /api/v1/jobs/{id} con enlace al resultado (GET /api/v1/jobs/{id}/result, disponible 7 días) y el webhook job.completed. Usa los ámbitos existentes members:write / members:read. Ver Webhooks.
2026-11-01	Añadido	Gestión de campañas: /api/v1/campaigns (alta, modificación, borrado de borradores, activate, pause), campos personalizados y reglas de participación. Ámbitos nuevos campaigns:read y campaigns:write. Ver API de gestión.
2026-11-01	Añadido	Catálogo de recompensas (/api/v1/rewards) y gestión de cupones: listado, emisión de lotes con Idempotency-Key obligatoria e invalidación. Ámbitos nuevos rewards:read, rewards:write, coupons:read y coupons:manage.
2026-11-01	Añadido	GET /api/v1/campaigns/{id}/raffles: sorteos realizados con ganadores y suplentes enmascarados (ámbito raffles:read).
2026-11-01	Añadido	GET /api/v1/member-attributes: esquema de los atributos personalizados de socio (ámbito read).
2026-11-01	Añadido	Webhooks de ciclo de vida: participation.created, participation.validated, participation.rejected, game.played, raffle.drawn, coupon.issued, member.updated, member.anonymized, payout.completed y payout.failed; prize.won pasa a incluir también a participantes sin cuenta de socio. Ver Webhooks.
2026-11-01	Añadido	Destino de webhook en tu cola SQS o tema SNS y export diario de eventos a S3 (NDJSON). Ver Eventos a tu cola o bucket.
2026-11-01	Añadido	OAuth2 client credentials (POST /connect/token) como alternativa a la clave API. Ver OAuth2.
2026-11-01	Añadido	Ámbitos admin:* y admin:<permiso> para llamar a /api/services/app/* con una cuenta de servicio. Ver Ámbitos de administración.
2026-11-01	Añadido	Modo pruebas de la cuenta y claves mk_test_; cabecera X-IncentIA-Test-Mode. Ver Modo pruebas.
2026-11-01	Añadido	Gestión del programa y de sus niveles: GET/POST /api/v1/programs, GET/PATCH/DELETE /api/v1/programs/{id} y lo mismo en /api/v1/tiers. Scopes nuevos programs:read y programs:write (hay que concederlos expresamente, también a las claves sin scopes). Listas paginadas por cursor.
2026-11-01	Añadido	Idempotency-Key también en los PATCH y DELETE de /api/v1/*.

2026-10

Fecha	Tipo	Cambio
2026-10-31	Añadido	Idempotency-Key en los POST /api/v1/*: un reintento con la misma clave y el mismo contenido no repite la operación.
2026-10-31	Añadido	Paginación por cursor en las transacciones de un socio: la respuesta incluye nextCursor y limit admite hasta 200. La paginación por offset sigue funcionando.
2026-10-27	Corregido	Reenviar un externalReference ya usado con otro tipo de operación devuelve 409 y no mueve puntos. Un reenvío del mismo tipo sigue siendo idempotente.
2026-10-27	Corregido	offset fuera de rango se ajusta en lugar de fallar.

Anteriores

Tipo	Cambio
Cambiado	Las compras con importe cero o negativo se rechazan.
Añadido	Webhooks salientes con firma X-Signature en formato v1= sobre {X-Timestamp}.{X-IncentIA-Idempotency-Key}.{cuerpo}. Ver Webhooks.

Cómo enterarte de los cambios

• Esta página se actualiza en el mismo cambio que modifica el contrato.
• Las deprecaciones se avisan además a los administradores de la cuenta, con los plazos de la política.