Uma API é a interface

Uma API define como um sistema pede a outro uma informação ou uma ação. Para uma plataforma de cassino, isso pode significar solicitar um catálogo de jogos, abrir uma sessão ou responder a uma chamada de carteira. O contrato precisa especificar a autenticação, os identificadores, os campos obrigatórios, os erros e o comportamento das novas tentativas.

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, com um número de requisição e com dados ou com um erro. A sua descrição é pública, como um arquivo OpenAPI e uma página de documentação.

Ter uma API diz como se comunicar. Ela não diz, por si só, a quantos estúdios você pode chegar nem qual conteúdo está disponível para a sua conta. São duas perguntas que convém fazer separadamente na avaliação.

A agregação é o serviço por trás da interface

Um agregador reúne o conteúdo de muitos estúdios em um modelo comum de integração e operação. O seu trabalho pode incluir um catálogo compartilhado, o controle de qual conta vê quais jogos, uma estrutura de contas para parceiros e clientes, relatórios e acompanhamento durante a conexão. O alcance exato muda de um serviço para outro.

Por isso, pergunte o que está incluído em vez de presumir. A palavra agregador não cobre automaticamente as contas dos seus jogadores, os pagamentos, as ferramentas de risco nem todos os estúdios de um diretório público. Com a WGC, por exemplo, o diretório lista 184 estúdios, mas os jogos liberados para a sua conta são decididos pelo seu gerente.

Compare o trabalho que a sua equipe assumirá

Com conexões separadas a cada provedor, os seus engenheiros mantêm os contratos individuais e as diferenças entre eles. Com um agregador, você trabalha contra o contrato comum dele para os fluxos compatíveis, embora ainda precise verificar o comportamento de cada jogo. Compare estes pontos:

  • Sincronização do catálogo: como você obtém primeiro a lista completa e depois as mudanças. A WGC devolve 200 jogos por página, e depois do primeiro download você pede apenas as mudanças com o horário da sua última sincronização.
  • Identificadores de jogo: um número para o jogo no seu catálogo e um para o mesmo jogo em todo o catálogo.
  • Parâmetros de lançamento: a WGC precisa do identificador do jogador, da moeda, do modo e de um número de jogo, e devolve um link de lançamento.
  • Mensagens da carteira: quais chamadas você responde e como.
  • Responsabilidade pelo suporte: quem ajuda quando algo falha.

Uma primeira integração menor só ajuda se a sua equipe também conseguir diagnosticar os erros depois. Por isso, faça a comparação não apenas para o dia da primeira conexão, mas também para a operação mensal depois de entrar no ar.

O nome de um jogo não é um identificador

Nomes de jogo parecidos não bastam para identificar o mesmo jogo. É por isso que a WGC dá a cada jogo um publicId estável e um universalId que é o mesmo para o mesmo jogo em todo o catálogo. Os nomes servem para exibir, e os identificadores servem para fazer a correspondência. Para a sua lista de lançamento, confirme os jogos realmente disponíveis para a sua conta e quais moedas e países cada um aceita, e verifique as condições comerciais separadamente da marca exibida no lobby.

Perguntas para uma revisão técnica

Use estas perguntas com qualquer agregador; é útil receber as respostas por escrito para facilitar as avaliações seguintes.

  1. Chaves. Como são tratadas as credenciais revogadas? Com a WGC, você cria e revoga as chaves no back office, com até cinco chaves de produção e até duas chaves de teste.
  2. Liberações vazias. O que acontece quando nenhum jogo é liberado para a conta? Na WGC, a resposta é uma lista vazia bem-sucedida, e não um erro.
  3. Mudanças do catálogo. Como as mudanças são expostas? A WGC devolve apenas as mudanças posteriores ao horário da sua última sincronização e recomenda uma sincronização completa pelo menos uma vez por dia.
  4. Novas tentativas seguras. Quais operações podem ser repetidas com segurança? Uma chave de idempotência, válida por 24 horas, devolve a mesma resposta para a mesma requisição de sessão, e uma abertura repetida do mesmo jogador e jogo devolve a mesma sessão enquanto ela estiver aberta.
  5. Erros. É possível obter um exemplo de erro com uma referência para o suporte? Toda resposta carrega um número de requisição.
  6. A carteira. Estabeleça a identidade da transação, o tratamento de duplicatas, os tempos limite e a conciliação antes do tráfego real. Na WGC, uma aposta é registrada uma única vez por identificador de transação, e a WGC espera três segundos pela sua resposta.

Como isso se aplica à WGC

A World Gaming Connect combina um back office B2B com acesso ao catálogo, abertura de sessões e o Callback da carteira. Para o controle operacional, há uma árvore de contas, com permissões de equipe, e um saldo comercial em USD. O suporte faz parte do quadro: o Ask WGC responde a partir da documentação, e o suporte ao vivo funciona dentro do back office.

O próximo passo é combinar com a equipe o alcance do seu conteúdo e o seu plano de testes; uma chave de teste abre um jogo de teste sem dinheiro. A prontidão de cada projeto é confirmada separadamente, então este artigo não implica que todos os estúdios ou fluxos listados estejam prontos para o seu projeto. Para os detalhes técnicos, veja a visão geral da API de cassino, e para o serviço em si, a página do agregador de jogos, o catálogo de provedores e os passos de integração.