TADA API — Documentação

Resumo no browser. Tutorial completo em arquivo: TADA-API/TUTORIAL.md (abra no editor).

← Demo / Launcher Health JSON Lista de jogos

Início rápido

cd "C:\Users\pedro\Desktop\Nova pasta\TADA-API"
copy .env.example .env
npm install
npm start

# Browser:
http://localhost:5757/demo

URLs

URL	Função
`/demo`	Launcher visual — busca e joga
`/doc`	Esta página
`/api/health`	Status da API + qtd de jogos
`/api/games`	JSON com todos os jogos indexados
`POST /api/launch`	Cria sessão e devolve `launch_url`
`/api/session/:id`	Saldo e stats da sessão
`POST /sso-login.api`	Login do client Cocos
`POST /:game/plainreq?ack=N`	Info (1) / Spin (0) em protobuf
`WS /lifeservice/ws2`	Keep-alive do jogo

Como usar o demo

Deixe npm start rodando no terminal
Abra /demo
Busque por nome ou ID (ex.: 40049, Super Ace)
Ajuste o Saldo se quiser
Clique Jogar — abre nova aba com o jogo
Opcional: botão Recarregar catálogo se baixou jogos novos

Launch (API)

POST /api/launch
Content-Type: application/json

{
  "gameId": "40049",
  "balance": 10000,
  "currency": "BRL",
  "user_id": "jogador_demo"
}

Resposta:

{
  "status": 1,
  "launch_url": "http://localhost:5757/fullhouse/?sip=localhost:5757&ssoKey=...",
  "session": "sess_...",
  "balance": 10000
}

Abra o launch_url no navegador. Não abra só o index.html sem query params — o client precisa de sip e ssoKey.

PowerShell

$r = Invoke-RestMethod -Method POST http://localhost:5757/api/launch `
  -ContentType "application/json" `
  -Body '{"gameId":"40049","balance":10000}'
Start-Process $r.launch_url

# Ver saldo depois de jogar:
Invoke-RestMethod http://localhost:5757/api/session/$($r.session)

Configuração (.env)

Variável	Padrão	Nota
`PORT`	5757	WG usa 5656
`BASE_URL`	http://localhost:5757	Deve bater com a URL do browser
`GAMES_DIR`	./games	Jogos dentro da API (40xxx_*)
`DEFAULT_BALANCE`	10000	Saldo demo

Fluxo do jogo

/api/launch cria sessão e URL
Browser carrega assets em /fullhouse/ (exemplo)
Client chama /sso-login.api
WebSocket /lifeservice/ws2
plainreq?ack=1 (info) e ack=0 (spin)

Limitações

Spin com engine genérico (não é math oficial de cada título)
Saldo só em memória — reiniciar o Node zera sessões
Sem MySQL / webhook de operador (modo demo)
Downloads incompletos podem faltar asset

Problemas comuns

0 jogos — confira a pasta TADA-API/games e GAMES_DIR=./games
Trava no loading — F12 → Network (404?) ou download partial; teste Super Ace 40049
Saldo não bate — abra sempre pelo launch_url, não o HTML solto
Porta em uso — mude PORT e BASE_URL no .env

Tutorial completo (instalação, rede local, WG lado a lado, checklist): arquivo TUTORIAL.md na pasta do projeto.

← Voltar ao demo