Changelog
Histórico de versões e mudanças da integração FourPlay
Versão atual
A integração FourPlay está em versão inicial. Esta documentação descreve o estado atual da API conforme implementada.
API Atual
Session API
| Endpoint | Método | Descrição |
|---|---|---|
/api/operator/session/create | POST | Cria sessão e retorna token JWT |
/api/operator/session/validate | POST | Valida token e retorna claims |
Base URL: https://mines.fourplay.studio
Autenticação: HMAC-SHA256 com headers X-Operator-Id, X-Timestamp, X-Signature
Fórmula HMAC: HMAC-SHA256(secretKey, apiKey + timestamp_ms + JSON.stringify(body))
Wallet Callbacks (implementados pelo operador)
| Endpoint | Método | Descrição |
|---|---|---|
{callbackUrl}/wallet/balance | POST | Consulta saldo do jogador |
{callbackUrl}/wallet/debit | POST | Debita aposta |
{callbackUrl}/wallet/credit | POST | Credita ganho |
{callbackUrl}/wallet/rollback | POST | Reverte debit em caso de erro |
Sessão JWT
- Claims:
playerId,operatorId,username?,isDemo? - Expiração: 24 horas após criação
- Algoritmo: HS256
Jogo
- Mines:
https://mines.fourplay.studio/?token={token} - Comunicação jogo ↔ servidor: WebSocket (Socket.IO)
Notas de Implementação
Formato de erros:
Erros do Mines Provider retornam { "message": "..." }. Erros do Portal Admin retornam { "error": "..." }.
Timestamps:
O X-Timestamp deve estar em milissegundos (13 dígitos). A janela de tolerância é ±5 minutos (300.000 ms).
Callbacks:
Todos os 4 callbacks são POST. O /wallet/balance também é POST (não GET). O rollback não tem seu body de resposta lido pelo servidor — apenas o status HTTP 200.
Política de Comunicação de Mudanças
Mudanças na API serão comunicadas diretamente para o e-mail técnico cadastrado no Portal Admin. Para garantir o recebimento de notificações:
- Mantenha o e-mail técnico atualizado no Portal Admin
- Para mudanças críticas, a equipe FourPlay entra em contato com antecedência mínima de 30 dias
- Dúvidas sobre mudanças: suporte@fourplay.studio