O que é uma API de cassino
Uma API é uma forma definida de um sistema pedir a outro uma informação ou uma ação. Uma API de cassino aplica essa ideia à operação de um cassino online: a sua plataforma pede jogos e os abre, e o lado do conteúdo pergunta à sua plataforma sobre saldos e apostas. O contrato dá nome às requisições, aos campos, às respostas e aos erros, de modo que duas equipes podem construir sobre ele sem precisar conversar todos os dias.
A API da WGC é uma interface de servidor para servidor. O seu servidor a chama com uma chave no cabeçalho X-API-Key, e toda resposta chega no mesmo envelope: um indicador ok, um identificador de requisição e dados ou um erro. O seu código deve ramificar apenas pelo código de erro, porque a mensagem é escrita para as pessoas. Os navegadores não chamam a API e chamadas entre origens não são aceitas, então a chave fica no seu servidor.
As quatro tarefas de uma API de cassino
1. O catálogo. A sua plataforma pede os jogos liberados para a sua conta, 200 por página. Cada jogo tem um publicId estável que o identifica no seu catálogo e um universalId que é o mesmo para o mesmo jogo em todo o catálogo. Ele também tem um nome, um tipo, endereços de imagem e indicadores de demo, rodadas grátis e outros recursos. Depois do primeiro download completo, você envia o horário da sua última sincronização e recebe apenas as mudanças, com um indicador para os jogos que devem ser retirados.
2. Abrir um jogo. Quando um jogador escolhe um jogo no seu lobby, o seu servidor pede à API que o abra. A requisição leva o identificador do jogador, a moeda, o modo (real ou demo) e o número de um jogo. A resposta é um link de lançamento que o navegador do jogador abre, dentro de um quadro, se você preferir. O link ainda não aberto funciona por cinco minutos, e um link aberto funciona enquanto o jogador estiver ativo.
3. A carteira. Durante o jogo, o jogo precisa de um saldo e tem de registrar apostas e ganhos. Em um modelo de carteira seamless, o dinheiro do jogador fica na sua plataforma, então é a API que chama você: a WGC envia requisições assinadas ao seu Callback URL com três comandos, um para ler o saldo, outro para registrar uma aposta junto com o seu ganho e outro para cancelar uma aposta. Esse é o tema da página de carteira seamless.
4. As consultas de status. Depois, a sua plataforma pode perguntar o que aconteceu com uma operação, uma rodada ou uma sessão, usando os seus próprios números. Uma operação tem um status como aceita, recusada, falha ou desconhecida, e uma rodada informa a aposta, o ganho e a diferença.
Duas direções de chamadas
Ajuda imaginar as chamadas indo nos dois sentidos. Na primeira direção, o seu servidor chama a WGC: lê o catálogo, abre jogos e consulta status. Na segunda direção, a WGC chama a sua plataforma: lê saldos e registra apostas, ganhos e cancelamentos. As duas direções fazem parte do mesmo contrato, e uma integração só está concluída quando as duas funcionam.
A segunda direção carrega as regras mais rígidas, porque movimenta dinheiro. Cada chamada é assinada com HMAC-SHA256 e o segredo da sua conta, e o seu manipulador deve verificar a assinatura sobre o corpo bruto antes de analisá-lo. A WGC espera pela sua resposta por três segundos. Uma aposta é registrada uma única vez por identificador de transação, de modo que uma chamada repetida não debita o jogador duas vezes nem altera o saldo devolvido.
Como uma rodada viaja
Este é o caminho de um único jogo, passo a passo.
- A sua plataforma sincronizou o catálogo e mostra os jogos no seu lobby.
- O jogador escolhe um jogo e o seu servidor pede para abri-lo.
- A WGC devolve um link de lançamento e o navegador do jogador o abre.
- O jogo pede o saldo. A WGC chama o seu Callback URL, você responde e o jogo começa.
- A cada aposta, a WGC chama você de novo com a aposta e, normalmente na mesma chamada, o seu ganho.
- Se a sua resposta não chegar a tempo, a aposta é recusada ao estúdio, a operação fica como desconhecida e a WGC depois pede que você a cancele com um rollback.
- Depois da rodada, a sua plataforma pode consultar a operação, a rodada ou a sessão pelos seus próprios números.
O que torna uma API de cassino fácil de verificar
Uma equipe técnica deveria poder avaliar uma API antes de se comprometer com ela. Com a WGC, a descrição da API é pública: um arquivo OpenAPI e uma página de documentação, ambos abertos sem chave. Se eles diferirem, vale o arquivo. A API não quebra sem aviso: campos novos podem aparecer, então você ignora os que não conhece, e um campo só é removido após um aviso de descontinuação e não antes de 90 dias.
Os limites também estão escritos. Por padrão, uma chave pode abrir 600 jogos por minuto, e as requisições de catálogo e de status permitem 120 por minuto. O seu gerente pode aumentar os limites de uma conta sob consulta.
Testar não exige dinheiro real. Uma chave de teste abre um jogo de teste, o WGC Test Slot, que faz chamadas reais ao seu Callback URL. No backoffice, uma verificação de integração mostra um registro ao vivo de cada chamada, e um teste de integração executa 14 verificações da sua carteira. Os exemplos de manipuladores, um script de verificação e uma lista de entrada em produção são públicos. Você pode ler mais na página de integração e em demo e modo de teste.
O que uma API de cassino não é
Uma API de cassino não é um cassino para jogadores. A WGC não opera um cassino, não mantém saldos de jogadores e não cadastra jogadores: a sua plataforma guarda os seus próprios jogadores e o dinheiro deles. O acesso à área de clientes é entregue pessoalmente por um gerente, e não existe cadastro por conta própria. Uma API de cassino também não é uma promessa sobre o resultado de um jogo: um RTP escolhido é um ajuste entregue ao estúdio, e nem todo jogo o aceita.
Para a lista completa de requisições e como elas se encaixam, veja a visão geral da API de cassino.