Como usar a API de um painel SMM para automatizar pedidos

Se você revende serviços ou tem um sistema próprio, a API permite enviar pedidos sem passar pelo painel. O padrão é bem parecido entre painéis, o que facilita a integração.

O básico

As chamadas são feitas por POST para um único endereço, com a sua chave e a ação desejada. A resposta vem em JSON.

• key: sua chave de API, encontrada na página da conta.
• action: o que você quer fazer.

Ações mais usadas

1. services — lista todos os serviços, com id, preço, mínimo e máximo.
2. add — cria um pedido. Requer service, link e quantity.
3. status — consulta um pedido pelo id.
4. orders — consulta vários pedidos de uma vez.
5. refill — solicita reposição de um pedido.
6. balance — consulta o saldo da conta.

Boas práticas

• Guarde a lista de serviços em cache. Ela muda pouco e consultar a cada pedido é desperdício.
• Consulte status em lote. Use a ação de vários pedidos em vez de um por um.
• Valide o link antes de enviar. Link errado consome saldo e não tem devolução.
• Trate erro de saldo separadamente. É o erro mais comum em produção.
• Nunca exponha a chave no navegador. Ela deve ficar no seu servidor.

Erros comuns

Enviar quantidade fora do mínimo ou máximo do serviço; usar o id de serviço de outro painel; repetir o mesmo pedido por falta de controle de idempotência; e consultar status a cada poucos segundos, o que costuma gerar bloqueio temporário.

Ritmo de consulta

Para acompanhar pedidos, uma consulta a cada poucos minutos é suficiente. Pedidos levam de minutos a horas, então consultar de segundo em segundo só gasta requisição.

Resumo

A API resolve escala: pedidos automáticos, status em lote e reposição sem intervenção manual. Guarde a chave no servidor, respeite os limites de cada serviço e consulte em ritmo compatível com o tempo real de entrega.