Integração de API de cassino para plataformas de jogos

A API de cassino da WGC é uma interface de servidor para servidor para operadores. Com ela, a sua plataforma recebe o catálogo de jogos liberado para a sua conta, abre jogos para os jogadores, responde às chamadas de carteira e lê o status das suas próprias operações. Esta página resume como ela funciona; as etapas para entrar em produção estão na página de integração. A seguir você verá primeiro a autenticação e depois os jogos, a carteira e os limites.

Um envelope, uma chave

O seu servidor chama a API com uma chave no cabeçalho X-API-Key. Cada resposta usa o mesmo envelope, com um indicador ok, um identificador de requisição e dados ou um erro. Ramifique o seu código apenas pelo código de erro; a mensagem é escrita para as pessoas. A API não foi feita para navegadores e não aceita chamadas entre origens, ou seja, a sua chave nunca vai ao navegador e as chamadas são feitas apenas pelo seu servidor.

Você mesmo cria e revoga as chaves no backoffice: até cinco chaves de produção e até duas de teste, com o valor visível uma única vez. Uma chave de produção nova em uma conta com tráfego real começa a responder após 30 minutos, ou imediatamente quando uma segunda pessoa a confirma.

O que está disponível

Os métodos disponíveis são uma verificação de saúde que não precisa de chave, o catálogo de jogos, a abertura de uma sessão, três consultas de status pelos seus próprios números (uma transação, uma rodada e uma sessão), uma consulta de sessões pelo seu próprio identificador de sessão, os limites de ganho e as chamadas de carteira que a WGC faz à sua plataforma. A descrição legível por máquina é um arquivo OpenAPI 3.1 que abre sem chave, e a descrição legível por pessoas é uma página de documentação pública. Se elas diferirem, vale o arquivo; por isso, ao escrever a sua integração, confie no arquivo para os detalhes.

Jogos e sessões

A requisição de jogos retorna os jogos liberados para a sua conta, 200 por página, cada um com um publicId, um universalId, um tipo, um endereço de imagem e indicadores de recursos. Depois de um primeiro download completo, você pede apenas as mudanças enviando o horário da sua última sincronização. Veja a visão geral do agregador de jogos e a API de slots para os detalhes do catálogo.

Uma requisição de sessão precisa do identificador do jogador, da moeda, do modo (real ou demo) e de um número de jogo. Você pode acrescentar o idioma, um endereço de retorno, a plataforma, o país do jogador, o seu próprio identificador de sessão e, para os jogos que os aceitam, um RTP de 75 a 96 e limites de aposta. Uma chave de idempotência, válida por 24 horas, devolve a mesma resposta para a mesma requisição, e uma abertura repetida do mesmo jogador e do mesmo jogo devolve a mesma sessão enquanto ela estiver aberta.

Carteira e consultas de status

Os saldos dos jogadores ficam na sua plataforma; ou seja, o dinheiro do jogador é mantido por você, e não pela WGC. A WGC chama o seu Callback URL com requisições assinadas para o saldo, para uma aposta e o seu ganho e para um rollback; o contrato é descrito em integração de carteira seamless. Depois você pode ler o status de uma operação, de uma rodada ou de uma sessão pelos seus próprios números. O registro das suas requisições à API é guardado por 90 dias.

Rodadas grátis

As rodadas grátis para um jogador podem ser concedidas pela API, mas o recurso vem desativado por padrão e é ativado a pedido seu. Ele não funciona para todos os jogos, e o bônus é pago como uma aposta. Consulte o seu gerente para saber se ele se encaixa no seu projeto; a ativação é combinada em conjunto.

Limites de ganho e RTP

Os limites de ganho podem ser lidos e alterados pela API com a permissão correspondente, e no backoffice você define linhas de parada para ganhos suspeitos: um único ganho, os ganhos de um jogador em uma hora e os de uma conta em uma hora, dentro dos limites da plataforma. O RTP e os limites de aposta de uma abertura são definidos na requisição ou no backoffice, para os jogos que os aceitam.

Limites e estabilidade

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. Rajadas vindas de um mesmo endereço são limitadas, e um excesso recebe uma resposta de limite de frequência com um tempo de espera. O seu gerente pode aumentar os limites de uma conta; você pode pedir isso para a sua. Sob consulta, as chamadas da sua conta também podem ser restritas a uma lista de endereços, de até 50 entradas.

Uma versão da API não quebra sem aviso. Campos novos podem aparecer, então ignore os campos que você não conhece. Um campo só é removido ou muda de significado após um aviso de descontinuação e não antes de 90 dias. Uma mudança incompatível seria uma versão nova, e a atual continuaria funcionando ao lado dela.

Teste primeiro

Uma chave de teste abre um jogo de teste que faz chamadas reais ao seu Callback URL, sem dinheiro, de modo que você pode percorrer todo o caminho antes de entrar em produção. Veja demo e modo de teste, as moedas para as regras de moeda, e as etapas de integração.

Perguntas frequentes

Existe uma descrição pública da API?

Sim: um arquivo OpenAPI 3.1 e uma página de documentação, ambos abertos sem chave.

Posso chamar a API de um navegador?

Não. É uma API de servidor para servidor.

Como obtenho uma chave?

Você mesmo a cria no backoffice, que o seu gerente abre para você.

Pronto para integrar? Vamos conversar sobre sua integração.

Sua próxima conexão
começa aqui.

Conte o que você está construindo. A partir daí, seguimos juntos.

Fale conosco