Registro de cambios

Cómo leer las versiones

La ruta lleva la versión mayor (/v1); info.version del documento OpenAPI lleva los cambios compatibles que se enumeran aquí. Todos son aditivos: ningún campo retirado, ningún campo obligatorio añadido. Una ruptura daría lugar a /v2, servida en paralelo. Cada entrada lleva la fecha del cambio.

1.2.0 — Los webhooks firmados.

Publicada el 5 de noviembre de 2026

• Puntos de acceso de los webhooks: GET y POST /v1/webhooks, GET, PATCH y DELETE /v1/webhooks/{id}, POST /v1/webhooks/{id}/rotate y POST /v1/webhooks/{id}/test. La lectura requiere read, cualquier cambio write; como máximo diez puntos de conexión por cuenta.
• Cuatro eventos —search.finished, prospect.replied, application.received, partner.approved— firmados según la especificación Standard Webhooks (webhook-id, webhook-timestamp, webhook-signature). El secreto whsec_ se muestra una sola vez; tras una rotación, el anterior sigue firmando durante 24 horas.
• Una entrega fallida se reintenta al cabo de 1 minuto, 5 minutos, 30 minutos, 2 horas y 12 horas. Los contenidos llevan identificadores y recuentos, nunca una dirección de correo ni un mensaje.
• Los webhooks no se exponen como herramientas MCP: sus secretos acabarían en las transcripciones de los asistentes.
• Una ruta desconocida bajo /api/v1 responde ahora 404 not_found en application/problem+json, tras la autenticación, en lugar de una página HTML.

1.1.0 — La captación de socios por la API, y el servidor MCP.

Publicada el 26 de octubre de 2026

• 29 operaciones nuevas para todo lo que hacen las pantallas de captación: los sitios, los criterios y sus términos temáticos generados, la búsqueda de socios y sus últimos resultados, la preselección y su paso a prospectos, los prospectos y la búsqueda de correo de pago, la búsqueda conversacional, el índice de creadores (búsqueda, ficha, perfiles similares, biblioteca de creadores encontrados), la competencia y la prospección: buzones, secuencias, inscripción. Ningún punto de acceso envía un correo directamente.
• Los ámbitos read, search, write y spend; las claves creadas antes de la 1.1 conservan exactamente read.
• La confirmación del coste: una operación que gasta créditos de proveedor requiere spend y un confirmCost al menos igual a la estimación; si no, responde 402 cost_confirmation_required con la estimación en error.details y no gasta nada. Los gastos confirmados quedan registrados.
• Idempotency-Key en las escrituras (24 horas, solo los éxitos), cuerpos de petición limitados a 32 KiB (413 payload_too_large), un tope de uso por cuenta además del tope por clave y 20 códigos de error nuevos.
• El servidor MCP en /api/mcp (Streamable HTTP, versiones del protocolo de 2025-11-25 a 2024-11-05): 29 herramientas calcadas de la API, con las mismas claves y ámbitos; las herramientas de pago se confirman en dos pasos con un confirmToken.

1.0.0 — El primer contrato, de solo lectura.

Publicada el 25 de julio de 2026

• Cuatro operaciones: el directorio público de programas (GET /v1/programs, GET /v1/programs/{slug}), la cuenta que llama (GET /v1/me) y sus comisiones (GET /v1/commissions).
• Claves portadoras gaff_live_…, guardadas como huella y mostradas una sola vez; un tope de uso por clave según el plan, con X-RateLimit-Limit, X-RateLimit-Remaining y Retry-After.
• Paginación por cursor, orígenes de navegador rechazados (CORS) y un documento OpenAPI 3.1 derivado de los esquemas que aplican las rutas.