O padrão da API v2 de painel SMM

O que é a API v2 de painel SMM?

É um único endpoint POST, por convenção em /api/v2, que recebe um corpo application/x-www-form-urlencoded e devolve JSON. A autenticação é um parâmetro key no corpo, e não num cabeçalho. Não há negociação de versão, assinatura de requisição nem nonce (especificação verificada em justanotherpanel.com/api, 6 de setembro de 2026).

A especificação nasceu nos scripts de painel dominantes e foi copiada tão amplamente que virou o padrão de fato do setor. Esse é o fato por trás de quase tudo o mais neste mercado: dá para lançar um painel numa tarde apontando um script para a API de um fornecedor, e é por isso que existem milhares de painéis e que a diferença entre eles é pequena.

Quais ações a API oferece?

Fonte: Especificação da SMM Panel API v2, verificada em justanotherpanel.com/api, 6 de setembro de 2026.

Repare que não existe uma ação multi_status separada na especificação canônica. O status de vários pedidos é a mesma ação status com o parâmetro no plural, orders, limitado a 100 ids por requisição, um detalhe que derruba a maioria das primeiras integrações.

Como são, na prática, uma requisição e uma resposta?

POST /api/v2
Content-Type: application/x-www-form-urlencoded

key=YOUR_KEY&action=services

// 200 OK
[
  {
    "service": 1,
    "name": "Followers",
    "type": "Default",
    "category": "First Category",
    "rate": "0.90",
    "min": "50",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

POST /api/v2
key=YOUR_KEY&action=add&service=1&link=https://example.com/p&quantity=1000

// 200 OK
{ "order": 23501 }

POST /api/v2
key=YOUR_KEY&action=status&order=23501

// 200 OK
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Partial",
  "remains": "157",
  "currency": "USD"
}

O campo rate é o preço por 1.000 na moeda da conta, devolvido como texto. Catálogos reais têm de 3.000 a 8.000 itens, então uma chamada services é uma única resposta grande, e não uma resposta paginada.

Quais armadilhas derrubam as primeiras integrações?

• Erros costumam voltar com HTTP 200. Na maioria dos painéis, uma requisição que falhou volta como 200 com um objeto de erro no corpo, e alguns respondem a uma chave inválida com 401 e o mesmo formato de JSON, então não dá para confiar no código de status e todo cliente precisa ler o corpo para detectar a falha.
• Números chegam como texto. rate, min, max, charge, start_count e remains são todos strings entre aspas; compará-los como números sem conversão dá errado em silêncio.
• O status de vários pedidos é o parâmetro no plural, não uma ação separada, e o limite é de 100 ids.
• A quantidade do drip-feed vale por execução. Uma chamada add com runs=10 entrega e cobra quantity × 10.
• Os ids de serviço são locais de cada painel e podem mudar. Um painel pode redirecionar um id para outro fornecedor de origem, então ids guardados podem, sem aviso, passar a significar outra coisa.
• refill e cancel só funcionam quando o item do catálogo os anuncia, e cancel em geral só antes de a entrega começar.

Quais parâmetros cada tipo de pedido exige?

Toda chamada add precisa de service e link. O que mais ela precisa é definido pelo campo type do item do catálogo, e não dá para adivinhar os requisitos. Esta tabela é a lista completa.

Fonte: Especificação da SMM Panel API v2, verificada em justanotherpanel.com/api, 6 de setembro de 2026.

Como construir uma integração com ela?

1. 1.Trate toda resposta como sem tipo. Leia o corpo primeiro, verifique se há uma chave error e depois converta explicitamente os números que vêm como texto.
2. 2.Guarde o id de serviço do painel junto com o seu próprio serviço padronizado e sincronize o catálogo em intervalos fixos, para que um id redirecionado seja detectado, e não presumido.
3. 3.Agrupe as consultas de status com o parâmetro orders no plural, em blocos de 100, em vez de uma requisição por pedido.
4. 4.Trate Partial como um resultado normal, não como erro. Ele vem com um valor em remains e um crédito automático no saldo.
5. 5.Nunca grave o corpo da requisição em log. A chave de API está nele.
6. 6.Troque as chaves em intervalos fixos e depois de cada mudança numa integração de terceiros.

O que a API revela sobre um painel?

Mais do que o texto de marketing. Acessar /api/v2 sem chave devolve uma resposta de erro válida se existir um endpoint compatível com a API v2, e um 404 desmente a alegação do painel de que tem API, uma verificação rápida e objetiva que qualquer pessoa pode fazer.

Ela também é o único jeito escalável de coletar preços comparáveis. A maioria dos painéis esconde o catálogo atrás do cadastro e só publica texto de marketing, então coletar as páginas públicas cobre uma minoria do mercado. Criar uma conta e chamar a ação services devolve o catálogo inteiro em JSON estruturado numa única requisição, e é assim que o PanelCompare monta o seu índice de preços.

Respostas rápidas

Leia em seguida

• Integração com a API de painel SMM: um passo a passo que funciona

  Uma integração completa e executável com a API v2 de painel SMM em Node, Python e PHP, com o tratamento de erros que a especificação realmente exige e os formatos de falha que derrubam as primeiras integrações.

  Ler

• Como abrir um painel filho

  O que é um painel filho, quanto custa mantê-lo, a margem que os revendedores realmente têm e as quatro coisas que quebram primeiro. Para quem está decidindo entre um painel filho e um painel completo.

  Ler

• Fornecedor ou revendedor: de quem você está comprando de verdade

  Como diferenciar um fornecedor de API de um painel revendedor, por que essa diferença muda o quanto você paga e a confiabilidade da entrega, e como os operadores escolhem um fornecedor de origem.

  Ler

• Drip-feed: como funciona a entrega gradual

  Como o drip-feed funciona, por que o campo de quantidade vale por execução e não no total, como escolher execuções e intervalo, e do que o drip-feed protege e não protege você.

  Ler