Changelog

A integração segue a política de versionamento: adições compatíveis dentro de uma versão, uma nova URL do SDK para mudanças incompatíveis.

v1 · 2026-10-16

Primeira versão pública da integração por iframe.

API

• POST /api/v1/integration/sessions também devolve launchToken (uso único, 120 segundos), launchExpiresAt e launchUrl, e aceita path e locale para a URL de abertura.
• Novo POST /api/v1/integration/launch: troca um launch token, uma única vez, pelo token de sessão. Recusas trazem details.reason: launch_token_invalid, launch_token_used, launch_token_expired.
• GET /api/v1/config expõe tenant.embedOrigins.
• As páginas do sportsbook trazem Content-Security-Policy: frame-ancestors a partir dos embedOrigins do tenant.

SDK de incorporação

• /embed/v1.js (global BookmakerSportsbook) e @bookmaker/embed-sdk (módulo ES com tipos): mount() com launch tokens, tamanhos auto e fill, links diretos, idioma, cada evento como callback e cada comando como método; verificação de origem em toda mensagem.

Protocolo postMessage v1

• Eventos: ready, resize, route, login_required, session_expired, balance_changed, bet_placed, bet_settled, deposit_requested, error.
• Comandos: set_launch_token, navigate, set_locale, refresh_balance, logout.

Obsoleto

• Abrir o sportsbook com o token de sessão na URL (?token=). Continua funcionando; migre para ?launch= ou para o SDK.