Changelog da API
Versão atual: 1.0.0 (OpenAPI 3.1). A base dos endpoints é a origem atual (/); veja a referência interativa.
Convenções
- Versão major no caminho:
/api/v1,/sdk/v1. Mudanças incompatíveis só numa nova major. - Marketplace (
/api/v1/*): cookie de sessão. SDK (/sdk/v1/*): bearersk_(no backend). Catálogo (/api/public/*): sem auth. - Erros:
{ error: { code, message } }.
1.1.0 agosto de 2026
Compatível com a 1.0.0 — só adições:
POST /api/v1/affiliations/{id}/coupon— o afiliado cria ou troca o próprio cupom. Sem corpo, o servidor gera; comcode, reserva o escolhido (4 a 20 caracteresA-Z0-9, único na plataforma).POST /api/v1/me/password— define a primeira senha da conta (quem entrou por link, código ou Google). Recusa senha vazada e só vale na janela logo após o login.GET /api/v1/advertiser/conversionsagora trazcommissionCentsecommissionStatusem cada venda.GET /api/v1/affiliationsagora trazcouponEnableddo programa.
1.0.0 · Fase 1 junho de 2026
Lançamento do marketplace multi-gateway:
- Catálogo público — programas e perfis de SaaS.
- Marketplace — anunciantes, SaaS, programas, afiliações, contratos, analytics, gateways, repasses.
- Integrações de pagamento — Stripe e Mercado Pago (OAuth); Asaas e AbacatePay (API-key).
- Tracking — redirect
/go/<code>, atribuição last-click com refund-hold e clawback. - SDK do widget —
/sdk/v1/affiliate,/statseafs.js. - Webhooks — ingestão assinada, idempotente, com fila e DLQ.
Roadmap
- Pagar.me (API-key).
- Reconciliação ativa — re-puxar eventos do gateway (hoje o agendador aplica mudanças de programa; o re-pull é roadmap).
- Comprovante de repasse (upload).