Jogos
GET /games escopo: games:read
Retorna o catálogo de jogos filtrado pela allowlist deste casino.
{
"games": [
{
"id": "sweet-bonanza",
"game_key": "pragmaticexternal:SweetBonanza",
"display_name": "Sweet Bonanza",
"provider": "pragmaticexternal",
"rtp": 96.6,
"status": "validated"
}
]
}
| Campo | Notas |
|---|---|
id | O que você passa como game_id ao criar uma batalha |
game_key | Qualificado pelo provedor, provider:GameName |
display_name | Cai para um id embelezado quando o jogo não tem perfil |
provider | Derivado do game_key, antes dos dois-pontos |
rtp | Percentual. 0 significa que o jogo não tem perfil, não um RTP de zero |
status | validated ou planned |
status
validated foi verificado ponta a ponta: a receita de gravação funciona, a compra de bônus
entra e o vídeo sai assistível.
planned significa que existe receita mas não existe perfil. Ele aparece no catálogo em
vez de ser descartado, para um operador ver que está vindo. Trate como não pronto para vender.
Allowlist vazia retorna catálogo vazio
{ "games": [] }
Um casino sem nada liberado vê zero jogos, e todo POST /battles falha com
403 game_not_allowed. Liberar jogos faz parte do onboarding.
Use a tela de jogos do console, se você tiver acesso; senão peça ao seu host para liberar os jogos combinados.
Mudanças de allowlist podem levar até 30 segundos
O catálogo que este endpoint serve é cacheado, então uma mudança de allowlist nem sempre aparece na chamada seguinte.
Uma mudança feita no console aparece na hora. Uma que o seu host faz para você pode levar até 30 segundos para chegar nesta API: a escrita funcionou e a mudança é real, mas ainda não se propagou.
Verificado ao vivo: GET /games continuou retornando {"games":[]} e POST /battles
continuou retornando game_not_allowed por cerca de meio minuto depois de a mudança ser
confirmada.
Se um jogo que você acabou de mandar liberar continua faltando, espere meio minuto e chame de novo antes de depurar qualquer outra coisa. Essa janela é o sintoma mais mal diagnosticado do SlotBattle, porque parece integração quebrada.
O catálogo não é por jogador
GET /games responde o que o casino pode rodar. Qual desses um jogador específico pode
jogar, cobrindo jurisdição, idade, autoexclusão e limites de jogo responsável, é decisão do seu
backend, e o SlotBattle não sabe nada sobre isso.
Próximo
- Batalhas: usando um
game_id - Tenancy: como as allowlists têm escopo
- Jogos no console