# Changelog da API pública do BetBackoffice

Versionamento semântico. Mudanças compatíveis (novos campos e endpoints) entram na mesma versão principal;
mudanças incompatíveis só em nova versão principal, com aviso prévio.

## 1.1.0 — 2026-09-25

- **Adicionado:** Sandbox isolado: chaves bk_test_ operam somente na marca br-sandbox, com dados separados da produção.
- **Adicionado:** Rotas de sandbox POST /sandbox/players/{playerId}/kyc/decision e POST /sandbox/withdrawals/{withdrawalId}/decision para simular a decisão da equipe (403 SANDBOX_ONLY em produção).
- **Adicionado:** Página de documentação em GET /docs com referência, primeiros passos e testador assinado (somente sandbox).
- **Adicionado:** Ferramentas públicas: GET /postman.json (coleção com assinatura HMAC), GET /signing-snippets.json e GET /test-vectors.json.
- **Adicionado:** OpenAPI com exemplos reais, code samples assinados (curl, Node.js, Python), grupos de tags e descrição de servidor.
- **Alterado:** GET /me passa a informar environment e brand.isSandbox. Em sandbox, POST /players/{playerId}/game-sessions cria uma sessão de demonstração (saldo fictício).
- **Corrigido:** Os operationId dos webhooks no OpenAPI eram gerados com colisão; agora são únicos (webhook_kyc_status_changed etc.).

## 1.0.0 — 2026-09-25

- **Adicionado:** Primeira versão: autenticação HMAC por operador, idempotência (Idempotency-Key), erros padronizados e OpenAPI.