Pular para o conteúdo

Endpoints do operador

O TechnoBin-Bridge comunica-se com plataformas operadoras através de endpoints pelo método POST, utilizando mensagens JSON.

As requisições do TechnoBin-Bridge contém um requestID único, que deve ser usado pelo operador para fins de rastreabilidade e idempotência. Ademais, é enviado no cabeçalho o token de acesso configurado no painel de gerência do TechnoBin. O cabeçalho das requisições tem o seguinte formato:

HeaderDescrição
Content-Typeapplication/json
AuthorizationBearer [Token de acesso]

É recomendado que o tempo de resposta das requisições seja menor que 500ms para evitar timeouts e garantir uma boa experiência ao usuário.


O endpoint /auth é utilizado para autenticar o usuário após ele acessar a URL do jogo. É recomendado expirar sessões após um período de tempo de inatividade, não permitindo sessões com validade maior que 24 horas.

CampoTipoDescriçãoObrigatório
requestIDstringID único de requisição no formato UUIDv4Sim
gameIDstringID do jogoSim
player.idstringID público do jogadorSim
player.sessionstringToken de sessão do jogadorSim
CampoTipoDescriçãoObrigatório
requestIDstringRetorno do requestID enviadoSim
authenticatedboolConfirma se a sessão foi autenticadaSim

O endpoint /wallet é utilizado para obter informações da carteira do jogador para mostrar o que for relevante na tela do jogo. Também pode ser utilizado como checagem de autenticação no fluxo de certos jogos.

CampoTipoDescriçãoObrigatório
requestIDstringID único de requisição no formato UUIDv4Sim
gameIDstringID do jogoSim
player.idstringID público do jogadorSim
player.sessionstringToken de sessão do jogadorSim
CampoTipoDescriçãoObrigatório
requestIDstringRetorno do requestID enviadoSim
player.idstringID público do jogadorSim
player.sessionstringToken de sessão do jogadorSim
player.nicknamestringApelido do jogadorSim
balance.currencystringMoeda do jogoSim
balance.amountnumberSaldo do jogadorSim

O endpoint /bet é utilizado quando o jogador quer fazer uma aposta no jogo. É de responsabilidade do operador garantir que o jogador realmente tenha fundos suficientes para completar a transação, além de debitar o valor utilizando uma operação atômica.

CampoTipoDescriçãoObrigatório
requestIDstringID único de requisição no formato UUIDv4Sim
gameIDstringID do jogoSim
roundIDstringID da rodada do jogoSim
player.idstringID público do jogadorSim
player.sessionstringToken de sessão do jogadorSim
bet.currencystringMoeda do jogoSim
bet.amountnumberValor da apostaSim
metadataobjectInformações adicionais dependendo do jogo*
CampoTipoDescriçãoObrigatório
requestIDstringRetorno do requestID enviadoSim
player.idstringID público do jogadorSim
player.sessionstringToken de sessão do jogadorSim
balance.currencystringMoeda do jogoSim
balance.amountnumberSaldo do jogador após a transaçãoSim

O endpoint /win é utilizado para creditar ganhos ao jogador.

CampoTipoDescriçãoObrigatório
requestIDstringID único de requisição no formato UUIDv4Sim
gameIDstringID do jogoSim
roundIDstringID da rodada do jogoSim
player.idstringID público do jogadorSim
win.amountnumberValor a creditarSim
metadataobjectInformações adicionais dependendo do jogo*
CampoTipoDescriçãoObrigatório
requestIDstringRetorno do requestID enviadoSim

O endpoint /refund é utilizado em casos de falhas críticas, cancelamentos de partidas multi-jogadores ou outros problemas técnicos para reembolsar os valores apostados ao jogador.

CampoTipoDescriçãoObrigatório
requestIDstringID único de requisição no formato UUIDv4Sim
gameIDstringID do jogoSim
roundIDstringID da rodada do jogoSim
refundsobject[]Reembolsos a serem feitosSim
refunds.requestBetIDstringID da requisição de aposta a ser reembolsadaSim
refunds.player.idstringID público do jogadorSim
refunds.refund.amountnumberValor do reembolsoSim
metadataobjectInformações adicionais dependendo do jogo*
CampoTipoDescriçãoObrigatório
requestIDstringRetorno do requestID enviadoSim