Documentação
A integração da nossa API é simples e prática. Para qualquer dúvida, não
deixe de nos chamar.
API URL: [Link]
OBS: API atualmente está em fase de testes 1°
Iniciar um jogo
Para iniciar uma nova sessão em um jogo, uma requisição via POST
deve ser feita para o endpoint “/api/v1/game_launch” com o seguinte
corpo(Body):
{
"agentToken": 234455345,
"secretKey": 23043050050,
"user_code": "isaacR",
"game_code": 126,
"user_balance": 20
}
“agentToken”: Token do agente
“secretKey”: Código secreto do agente
“user_code”: Código do jogador
“game_code”: Código do jogo
“user_balance”: Saldo do jogador
A resposta dessa requisição retornará um seguinte JSON(SUCESSO):
{
"status": 1,
"msg": "SUCCESS",
"launch_url": “url",
"user_code": "IsaacR",
"user_balance": 20,
"user_created": false,
"name": "Fortune Tiger",
"currency": "BRL"
}
“status”: representa que retornou com erro “0” ou sem erro “1”
“msg”: Especifica se teve algum erro ou a requisição foi um sucesso
“launch_url”: A URL do jogo
“user_code”: O código do jogador
“user_balance”: Saldo do jogador
“user_created”: Se o jogador foi criado na nossa database(Caso seja um
jogador novo, vai retonar “true”)
“name”: Nome do jogo
“currency”: Moeda da sessão do jogo
A resposta dessa requisição irá retornar um seguinte JSON(ERROR):
{
"status": "error",
"message": "Secret Key não cadastrado." }
“status”: representa que retornou com erro “0” ou sem erro “1”
“msg”: Representa se teve algum erro ou a requisição foi um sucesso
WEBHOOK
1° Saldo
Uma requisição via POST no seu webhook irá solicitar o saldo do
jogador com o seguinte corpo:
{
"type": "BALANCE",
"user_code": "isaac"
}
“type”: O tipo da requisição, nesse caso “BALANCE”
“user_code”: O código do seu usuário
A resposta deve ser retornada com o seguinte corpo:
{
"msg": "",
"balance": 20.00
}
Caso o usuário não exista, deverá ser retornado um erro
{
"msg": "INVALID_USER",
"balance": 0
}
“msg”: Representa se teve algum erro ou a requisição foi um sucesso
“balance”: Saldo do jogador
1° Aposta
Uma requisição via POST no seu webhook irá informar a situação de
uma aposta com o seguinte corpo:
{
"type": "WinBet",
"agent_code": "",
"agent_secret": "",
"user_code": "isaac",
"user_balance": 50,
"game_type": "slot",
"slot": {
"provider_code": "PGSOFT",
"game_code": 1695365,
"round_id": 93949595959,
"bet": 0,
"win": 0,
"txn_id": "23456665666",
"txn_type": "debit_credit",
"user_before_balance": 10,
"user_after_balance": 50,
"created_at": "2021-09-2"
}
}
“type”: O tipo da requisição, nesse caso “BALANCE”
“agent_code”: O código do seu agente
“agent_secret”: Código secreto do seu agente
“user_code”: O código do seu usuário
“user_balance”: Saldo do seu jogador
“game_type”: O tipo do jogo
“provider_code”: Provedor do jogo
“game_code”: Código do jogo
“round_id”: Id da rodada
“bet”: Valor perdido na aposta
“win”: Valor ganho na aposta
“txn_id”: Id único da transação
“txn_type”: Tipo da transação, geralmente “debit_credit”
“user_before_balance”: Saldo do jogador antes da aposta
“user_after_balance”: Saldo do jogador depois da aposta
“created_at”: Data da criação
A resposta deve ser retornada com o seguinte corpo:
{
"msg": "",
"balance": 20.00
}
Caso o usuário não exista, deverá ser retornado um erro :
{
"msg": "INVALID_USER",
"balance": 0
}
Caso o usuário não tenha fundos suficiente, deverá ser retornado com
erro:
{
"msg": "INSUFFICIENT_USER_FUNDS",
"balance": 0
}
“msg”: Representa se teve algum erro ou a requisição foi um sucesso
“balance”: Saldo do jogador
ERROS
Lista com erros que pode ser retornado pela API em
alguma requisição:
1° Erro 400:
• Voce precisa passar o user_code.
• User Balance deve ser um numero.
2° Erro 401:
• Agent Token não cadastrado.
• Secret Key não cadastrado 3° Erro 404:
• Código do jogo não encontrado 4° Erro 500:
• Erro ao cadastrar o usuario.