Painel SMM API: documentação

O que é a API de um painel SMM?

A API de um painel SMM permite que um programa obtenha a lista de serviços, faça pedidos e consulte o status dos pedidos e o saldo sem passar pelo site. A 4SNS PLUS suporta o formato padrão de API v2 para painéis SMM usado por muitos painéis e bots, então o código que você já conectou a outro painel funciona na hora, bastando trocar a URL e a chave.

Os preços e o saldo da API são os mesmos do site. O rate na resposta de services é igual ao preço por 1,000 (dólares americanos) da tabela de preços, e os pedidos feitos com add são descontados do seu saldo exatamente como os pedidos pelo site e também aparecem no histórico de pedidos do seu painel. Valores devolvidos de pedidos cancelados ou parciais voltam para o mesmo saldo.

Informações básicas

Exemplo de requisição

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

Como obter uma chave de API?

Assim que sua primeira recarga for creditada no saldo, você pode criar uma chave de API no menu Chave de API do seu painel. A chave aparece uma única vez ao ser criada, então guarde em um lugar seguro. Ao criar uma nova chave, a anterior é desativada na hora.

A chave é diferente do token da sua conta. Coloque apenas a chave de API no seu bot ou servidor, nunca o token da conta. Se achar que sua chave vazou, basta criar uma nova na tela Chave de API.

Lista de serviços (services)

Retorna todos os serviços que você pode pedir. rate é o preço por 1,000 (USD) e, quando type é Package, é o preço de um pacote. Quando type é Custom Comments, você envia uma lista de comentários em vez de uma quantidade. category é o nome da plataforma mais o nome do grupo.

Exemplo de resposta

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

Criar um pedido (add)

Cria um pedido e desconta o valor do seu saldo. O valor é o preço por 1,000 vezes a quantidade; em Package é o preço do pacote e, em Custom Comments, a quantidade é o número de linhas de comentário. Pedidos ficam disponíveis em contas com a primeira recarga creditada. O order na resposta é o ID do seu pedido.

Exemplo de resposta

{
  "order": 31877
}

Status do pedido (status)

O status de um pedido. charge é o valor realmente pago após reembolsos (USD, 6 casas decimais), start_count é a contagem no início do pedido e remains é a quantidade ainda não entregue.

Exemplo de resposta

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

Status de vários pedidos (status, orders)

Consulta até 100 pedidos de uma vez, com os IDs separados por vírgula. IDs que não existem ou não são da sua conta recebem um erro no lugar.

Exemplo de resposta

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

Solicitar reposição (refill)

Para um pedido de serviço com período de reposição que terminou como Completed ou Partial, solicite dentro do período de reposição contado a partir do término. Cada pedido pode ter uma solicitação aberta, com 24 horas entre solicitações.

Exemplo de resposta

{
  "refill": 512
}

Status da reposição (refill_status)

O status de uma solicitação de reposição.

Exemplo de resposta

{
  "status": "Completed"
}

Saldo (balance)

Seu saldo (USD, 6 casas decimais).

Exemplo de resposta

{
  "balance": "84.120000",
  "currency": "USD"
}

Valores de status do pedido

Valores de status da reposição

Mensagens de erro

Erros chegam como JSON com um campo error em uma resposta HTTP 200. No seu código, verifique primeiro o campo error.

{
  "error": "Not enough funds on balance"
}

Como conectar a API de um painel SMM a um bot de Telegram?