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.
- 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.
- 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.
- 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.
- 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.
- Erros. É possível obter um exemplo de erro com uma referência para o suporte? Toda resposta carrega um número de requisição.
- 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.