A requisição de sessão
O seu servidor abre um jogo para um jogador com POST /v1/sessions. A chamada é de servidor para servidor: a chave vai no cabeçalho X-API-Key, e o navegador nunca chama a API.
POST /v1/sessions
{"publicId":"sweet-bonanza-1","playerId":"casino-side-player-42","currency":"USD","mode":"demo","language":"en"}
→ 200 { "ok": true, "requestId": "req_…", "data": { "url": "https://play.worldgamingconnect.com/play/Zk3p9xQ2vL8mTn4r", "sessionId": "cmgq3r8v40001l8xyz5k2abcd", "expiresAt": "2026-10-12T10:45:00.000Z" } }Os campos obrigatórios são playerId, currency, mode e exatamente um entre publicId e universalId. O identificador do jogador tem de 1 a 64 caracteres ASCII imprimíveis e nomeia um jogador do seu próprio sistema: a WGC não cria nenhum jogador, porque a carteira fica no seu cassino. A moeda é um código de 3 a 8 letras, e o modo é real ou demo. Os campos opcionais definem o idioma, o endereço de retorno, a plataforma (desktop ou mobile), o país do jogador, o seu próprio número de sessão e, para os jogos que os aceitam, o RTP e os limites de aposta.
O que a resposta traz
url é o link de lançamento, sessionId é o número da sessão como o seu cassino o verá, e expiresAt é o horário até o qual um link não aberto funciona. Guarde o identificador da sessão: é o número com o qual você consulta a sessão mais tarde e o número que aparece nos relatórios. Anotá-lo nos seus registros junto com o jogador e o jogo permite encontrar a sessão de imediato em uma solicitação de suporte.
Abra o link no navegador do jogador
O link é um endereço próprio da WGC e deve ser aberto no navegador do jogador, redirecionando a página para ele ou colocando-o em um frame. Não o busque a partir do seu servidor. O link registra o dispositivo que o abre, e uma busca a partir do seu servidor seria registrada como a abertura do jogador. Por isso o seu servidor apenas recebe o link e o entrega ao jogador; abri-lo é tarefa do navegador.
Quanto tempo o link vive
- Um link que nenhum navegador abriu funciona por 5 minutos. Para abri-lo mais tarde, peça um novo com uma nova requisição de sessão.
- Depois que o navegador do jogador o abriu, o link vive enquanto o jogador continua jogando, isto é, enquanto continuam chegando chamadas de carteira.
- Depois que a sessão é encerrada, o link responde com uma página clara e o status 410. Para jogar de novo, o jogo é aberto outra vez a partir do seu lobby com uma nova requisição de sessão. Se o jogador guardou um link antigo, verá a mesma página; não é um erro, e sim um sinal claro de que a sessão terminou.
Coloque o link em um frame
O link pode ser colocado em um <iframe> com allow="fullscreen; autoplay". Não adicione um atributo sandbox a menos que ele traga pelo menos allow-scripts allow-same-origin allow-popups, porque um sandbox mais restrito impede o jogo de funcionar. Em alguns jogos o link funciona uma única vez: uma atualização em uma nova aba é uma segunda abertura. Quando isso acontecer, repita a requisição de sessão e abra o novo link, que é a mesma sessão com um endereço de jogo novo. Se um jogo fica vazio no seu frame mas abre em uma nova aba, escreva ao suporte ao vivo informando o jogo e o seu domínio.
O endereço de retorno e o idioma
returnUrl leva o jogador de volta ao seu lobby quando o jogo termina. Sem ele, a WGC mostra uma página neutra. Nem todo jogo aceita um endereço de retorno, e o lobby dentro do jogo não funciona em todos os estúdios, então ofereça aos jogadores uma saída do frame na sua própria página.
O idioma é um código ISO 639-1. Uma região como pt-BR é permitida e a região é cortada. Um código de país enviado no lugar de um idioma é substituído, de modo que ua vira uk. Um código desconhecido volta ao inglês, e o jogo nunca é recusado por causa do idioma. O que o jogo realmente mostra depende do estúdio; por isso não leia a exibição de um idioma como uma promessa e confira você mesmo as combinações de idioma importantes.
Uma sessão aberta por jogador e jogo
Enquanto uma sessão está aberta, uma segunda requisição para o mesmo jogador, jogo, moeda e modo devolve essa sessão e o mesmo link de lançamento. Duas aberturas no mesmo instante, como um clique duplo, respondem as duas com a mesma sessão, e se a primeira ainda não tem link, a outra responde try_later. Outro jogador, outra moeda ou outro modo é outra sessão. Depois que a sessão é encerrada, a abertura seguinte cria uma nova.
O cabeçalho opcional Idempotency-Key, válido por 24 horas, torna segura uma requisição repetida: a mesma chave e o mesmo corpo devolvem a mesma resposta sem uma nova chamada ao estúdio, e um corpo diferente é invalid_request. Uma chave não renova um link vencido: depois de expiresAt, abra a sessão com uma chave nova. Essas duas regras juntas evitam que um clique duplo ou uma nova tentativa de rede gerem sessões duplicadas para o jogador.
Recusas que você deve esperar
error.code | HTTP | O que fazer |
|---|---|---|
unauthorized | 401 | Verifique a chave. |
invalid_request | 400 | Corrija o campo que a mensagem nomeia. Um demo aberto com uma chave de produção também é recusado. |
not_found | 404 | O jogo não existe, não foi liberado para a sua conta ou não tem preço para ela. Não faça sondagem. |
currency_not_granted | 400 | A moeda não foi liberada para a sua conta. |
balance_required | 402 | Uma sessão real precisa de dinheiro na conta. Recarregue, ou abra um demo com uma chave de teste. |
country_restricted | 403 | O estúdio proíbe o jogo no país do jogador. Ofereça outro jogo. |
rate_limited | 429 | Aguarde os segundos indicados em Retry-After. |
try_later | 409 | A abertura anterior com esta chave ainda está em andamento. Tente de novo em um segundo. |
busy | 503 | A WGC está sob carga; tente de novo depois de Retry-After. |
Ramifique apenas por error.code; a mensagem é para as pessoas. Defina de antemão, para cada recusa, um texto curto para o jogador e o código que será guardado no seu próprio registro, de modo que uma recusa não deixe o jogador com dúvidas e seja rastreável para a sua equipe. Um jogo que não está disponível em alguma moeda fica marcado no catálogo, e um lançamento nessa moeda é recusado enquanto as demais moedas continuam funcionando. Um lançamento real precisa de fundos na sua conta comercial: o saldo mais o limite de crédito deve ser maior que zero, enquanto um lançamento demo não move dinheiro. A abertura de sessões é limitada por chave, e o valor padrão é 600 por minuto.
Ler uma sessão mais tarde
O seu servidor pode ler uma sessão pelo seu número com GET /v1/sessions/{sessionId}, que mostra o seu status, a moeda, o modo e os totais, ou encontrar as suas sessões pelo seu próprio número com GET /v1/sessions?casinoSessionId=. Só as sessões da sua conta são visíveis. Nas solicitações de suporte, cite o identificador da sessão, o número da requisição e o horário em UTC. Para o que acontece dentro de uma rodada, veja o fluxo da rodada, e para as repetições, o artigo sobre idempotência.
Veja a visão geral da API de cassino, os passos de integração, o modo demo e de teste e a página da carteira seamless para as chamadas que vêm depois do lançamento.