Ir para o conteúdo EXPLORE NOVAS POSSIBILIDADES
BUILT FOR DEVELOPERS

Uma API.
Novas possibilidades.

Do primeiro endpoint ao lançamento de um jogo.
Encontre o caminho para conectar sua plataforma.

Abrir referência completa
02 / PRIMEIRA CONEXÃO

Comece pelo catálogo.

A consulta de provedores é pública. Use o exemplo abaixo e adapte o formato ao seu ambiente.

curl --request GET "https://fendagame.site/api/providers" \
  --header "Accept: application/json"
GET/api/providers
03 / AUTENTICAÇÃO

Sua operação, identificada.

Os endpoints de operação usam credenciais do agente. No lançamento de jogos, envie os campos abaixo no corpo da requisição. Outros endpoints podem usar nomes de parâmetros diferentes; consulte o contrato correspondente.

CampoUso no lançamento
agent_codeCódigo de identificação do seu agente.
agentTokenToken de acesso do agente.
secretKeyChave secreta do agente.
Mantenha token e chave no servidor da sua aplicação. Não coloque credenciais reais no código público do navegador.
04 / CATÁLOGO

Encontre o próximo jogo.

Consulte as provedoras e os jogos para obter os identificadores usados na integração. A disponibilidade deve ser conferida nos resultados da API.

GET/api/providers
GET/api/providers/{slug}/games
GET/api/games
GET/api/games/category/{slug}

A referência completa detalha paginação, pesquisa e parâmetros de cada recurso.

05 / LANÇAMENTO

Da sua plataforma para o jogo.

Com as credenciais e os identificadores do catálogo, envie a requisição de lançamento pelo seu servidor. O exemplo usa valores ilustrativos.

POST/api/v1/game/launch
Exemplo de corpo · JSON
{
  "agent_code": "SEU_CODIGO",
  "agentToken": "SEU_TOKEN",
  "secretKey": "SUA_CHAVE",
  "player_code": "jogador_123",
  "game_code": "CODIGO_DO_CATALOGO",
  "provider": "SLUG_DO_PROVEDOR",
  "player_rtp": 96,
  "lang": "pt-BR"
}
Ver todos os parâmetros e respostas
06 / CALLBACKS

Conecte o fluxo da operação.

A integração pode usar uma URL de callback para a comunicação com sua plataforma. Configure a URL do seu servidor e siga os contratos específicos de consulta de saldo e transações descritos na referência.

O campo callbackurl pode ser informado no lançamento. Os detalhes de autenticação e os formatos variam conforme o recurso e a provedora.

SPORTSBOOK

Consulte modalidades, eventos, placares e mercados de Esportes e eSports. Cada produto precisa estar habilitado no plano e no agente. A API exige um IP autorizado e bloqueia o acesso ao fim da tolerância do plano.

Esportes

GET/api/v1/sportsbookModalidades
GET/api/v1/sportsbook/eventsAgenda e eventos ao vivo
GET/api/v1/sportsbook/events/{event_id}Detalhes
GET/api/v1/sportsbook/events/{event_id}/marketsMercados e odds
GET/api/v1/sportsbook/events/{event_id}/livePlacar e relógio

eSports

GET/api/v1/esportsModalidades
GET/api/v1/esports/eventsAgenda e eventos ao vivo
GET/api/v1/esports/events/{event_id}Detalhes
GET/api/v1/esports/events/{event_id}/marketsMercados e odds
GET/api/v1/esports/events/{event_id}/livePlacar e relógio

Na lista de eventos, use type=1 para partidas ao vivo ou type=3 para eventos do dia. Use sportId para selecionar uma modalidade, current para a página e size para até 50 resultados por página.

Consulta de eventos ao vivo
curl "https://fendagame.site/api/v1/sportsbook/events?type=1" \
  -H 'Authorization: Bearer SEU_TOKEN' \
  -H 'X-Agent-Code: SEU_CODIGO' \
  -H 'X-Agent-Secret: SUA_CHAVE'

401 indica falha na autenticação, 403 indica acesso bloqueado, 404 indica evento indisponível e 422 indica filtros inválidos.

07 / RESPOSTAS

Trate cada resposta.

Confira o status HTTP e o conteúdo JSON antes de continuar o fluxo. Respostas de validação incluem os campos que precisam de correção.

RespostaPróximo passo
2xxLeia a resposta do endpoint e prossiga com o fluxo correspondente.
409Confira a mensagem retornada. Consultas de catálogo podem indicar um recurso não encontrado.
422Revise os parâmetros enviados e os erros de validação informados.
429Aguarde antes de repetir a requisição. Alguns recursos possuem limites de chamadas.
Falar com o suporte