Testador de API para painel SMM

Como é uma requisição à API de um painel SMM?

Como o mercado roda sobre poucos scripts de painel, o formato da requisição é quase uniforme: um endpoint POST, campos de formulário e uma resposta em JSON. Uma chave identifica a conta, uma ação diz qual é a operação, e os demais campos são os argumentos da ação. As ações que você encontra em quase todo lugar são services, balance, add, status e refill.

Três coisas variam o suficiente para quebrar uma integração, e nenhuma delas é documentada de forma consistente. Limites de requisição, que a maioria dos painéis aplica sem publicar. O tratamento de erros: alguns painéis devolvem códigos de erro HTTP, muitos devolvem 200 com uma chave error no corpo; por isso, trate um 200 como “o servidor respondeu”, e não como “o pedido deu certo”. E os IDs de serviço, que são de cada painel e podem mudar quando um catálogo é refeito; qualquer integração que os guarda precisa conferi-los de novo com a ação services, em vez de usar um mapa fixo no código.

Perguntas frequentes

Esta ferramenta envia minha chave de API para os servidores de vocês?

Não. A requisição sai do seu navegador direto para o endpoint do painel. Não há rota de servidor, proxy nem registro de logs por trás desta página. Você pode confirmar isso no painel de rede do navegador, onde verá exatamente uma requisição, para o próprio domínio do painel. Uma chave de API de painel consegue gastar saldo depositado, e um site de comparação não tem por que guardar uma, nem mesmo de passagem.

Por que a requisição falha com erro de rede?

Quase sempre é CORS. As APIs de painel são feitas para chamadas de servidor para servidor e não enviam o cabeçalho Access-Control-Allow-Origin que o navegador exige antes de entregar a uma página uma resposta de outra origem; por isso, o navegador descarta a resposta, mesmo que a requisição geralmente tenha chegado. A ferramenta detecta isso e dá a você um comando curl equivalente para rodar no seu próprio terminal, onde nenhuma política de CORS se aplica.

O que as APIs de painel têm em comum?

Mais do que você imagina, porque o mercado roda sobre poucos scripts de painel. O formato comum é um único endpoint POST que recebe uma chave, uma ação e os parâmetros da ação como campos de formulário, e devolve JSON. As ações de sempre são services, balance, add, status e refill. O que nunca é igual entre painéis são os IDs de serviço: cada painel tem os seus; por isso, uma integração que os deixa fixos no código quebra na migração.

É seguro testar a ação "add"?

Ela faz um pedido real e gasta saldo real; por isso, trate-a como uma transação de verdade. Use a menor quantidade que o serviço permite, num link que você controla, e consulte a ação status depois, em vez de supor que o pedido entrou porque a chamada devolveu 200: vários painéis devolvem 200 com uma mensagem de erro no corpo.