Desenvolvedores

Integração e API

Documentação pública para conectar seu jogo idle ao TOPIDLE200: busca de jogos e webhooks de recompensa de voto. Cadastre o jogo em /cadastrar antes de integrar.

GET /api/search

Busca pública de jogos aprovados (mínimo 2 caracteres).

Query: q (texto)
Resposta JSON com array results (id, slug, name, posição e votos)
Exemplo: https://topidle200.com/api/search?q=poke

Webhook de recompensa de voto

Jogos parceiros podem confirmar recompensa após um voto válido. O payload usa assinatura HMAC; detalhes de chave e endpoint são liberados após aprovação do cadastro e plano elegível. Em caso de dúvida, escreva para contato.

Ranking e votos

O placar público está em /ranking. Votos exigem login (Google ou Discord), captcha e intervalo conforme o plano do jogo. Regras completas em como funciona.

Roadmap da API

Endpoints adicionais (listagem paginada de jogos, ranking por mês, detalhes por slug) estão no roadmap. Esta página será atualizada quando forem publicados em produção.