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/*): bearer sk_ (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; com code, reserva o escolhido (4 a 20 caracteres A-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/conversions agora traz commissionCents e commissionStatus em cada venda.
  • GET /api/v1/affiliations agora traz couponEnabled do 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, /stats e afs.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).