Nesta página

Documentação da API do painel SMM

Versão API: v2

SmmFoxi fornece uma API de painel SMM padrão (v2) para integrar 373 serviços de marketing em redes sociais diretamente no seu painel de revendedor, bot ou app. Início rápido nos serviços elegíveis, preços competitivos e automação completa. Esta documentação cobre todos os endpoints disponíveis e o seu uso.

Antes de começar: acesso à API em 4 passos

Antes da primeira chamada, você precisa de uma conta, saldo e uma chave de API. A configuração leva poucos minutos:

  1. 1

    Crie uma conta

    Cadastre-se no SmmFoxi. A mesma conta é usada no painel web e na API.

    Cadastrar →
  2. 2

    Adicione saldo

    Os pedidos via API são cobrados do saldo da sua conta. Adicione fundos no painel; você pode consultar o saldo a qualquer momento com action=balance.

    Abrir painel →
  3. 3

    Obtenha sua chave de API

    Acesse Painel → API e gere uma chave. Ela é exibida por completo apenas uma vez — copie e guarde em local seguro. Ao renová-la, a chave antiga deixa de funcionar imediatamente.

    Obter chave de API →
  4. 4

    Integre e teste

    Envie solicitações POST para o endereço abaixo com sua chave e uma action. Comece com action=services para obter os IDs e preços dos serviços e depois faça um pequeno pedido de teste.

    Ver endereço →

Endpoint API

https://smmfoxi.com/api/v2

Todas as requisições devem ser enviadas para este endpoint via método POST ou GET.

Autenticação

Todas as solicitações da API exigem autenticação com sua chave de API. Gere-a em Painel → API (a chave completa é exibida apenas uma vez, salve-a imediatamente). Inclua o parâmetro key em todas as solicitações.

POST https://smmfoxi.com/api/v2
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

Formato de resposta

Todas as respostas são retornadas em formato JSON. Requisições bem-sucedidas retornam os dados solicitados, enquanto erros retornam um objeto com uma descrição.

Endpoints API

Obter serviços

Retorna uma lista de todos os serviços disponíveis com seus detalhes incluindo preços, quantidades mínimas e máximas.

Parâmetros

  • key - Sua chave API (obrigatório)
  • action - "services"
// Exemplo de resposta
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

Obter saldo

Retorna o saldo atual da sua conta e a moeda.

Parâmetros

  • key - Sua chave API (obrigatório)
  • action - "balance"
// Exemplo de resposta
{
  "balance": "100.84292",
  "currency": "USD"
}

Adicionar pedido

Criar um novo pedido para um serviço. Os parâmetros necessários dependem do tipo de serviço.

Tipo padrão

  • key - Sua chave API (obrigatório)
  • action - "add"
  • service - ID do serviço (obrigatório)
  • link - URL de destino (obrigatório)
  • quantity - Quantidade do pedido (obrigatório)

Tipo pacote

  • key - Sua chave API (obrigatório)
  • action - "add"
  • service - ID do serviço (obrigatório)
  • link - URL de destino (obrigatório)

Tipo comentários personalizados

  • key - Sua chave API (obrigatório)
  • action - "add"
  • service - ID do serviço (obrigatório)
  • link - URL de destino (obrigatório)
  • comments - Comentários separados por quebra de linha (obrigatório)
// Exemplo de resposta
{
  "order": 23501
}

Status do pedido

Obter o status de um ou mais pedidos. Você pode consultar um único pedido ou vários de uma vez.

Pedido único

  • key - Sua chave API (obrigatório)
  • action - "status"
  • order - ID do pedido (obrigatório)

Múltiplos pedidos (até 100)

  • key - Sua chave API (obrigatório)
  • action - "status"
  • orders - IDs dos pedidos separados por vírgula (obrigatório)
// Exemplo de resposta
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

Criar reabastecimento

Solicitar um reabastecimento para um pedido. Disponível apenas para serviços que suportam reabastecimentos.

Parâmetros

  • key - Sua chave API (obrigatório)
  • action - "refill"
  • order - ID do pedido (obrigatório)
// Exemplo de resposta
{
  "refill": "1"
}

Status do reabastecimento

Verificar o status de uma solicitação de reabastecimento.

Parâmetros

  • key - Sua chave API (obrigatório)
  • action - "refill_status"
  • refill - ID do reabastecimento (obrigatório)
// Exemplo de resposta
{
  "status": "Completed"
}

Status dos pedidos

  • Pending - O pedido está aguardando processamento
  • Processing - O pedido está sendo preparado
  • In progress - O pedido está em execução
  • Completed - O pedido foi concluído com sucesso
  • Partial - O pedido foi parcialmente concluído (reembolso pelo restante)
  • Canceled - O pedido foi cancelado

Tratamento de erros

Quando ocorre um erro, a API retorna um objeto JSON com um campo error descrevendo o problema.

// Exemplo de resposta de erro
{
  "error": "Invalid API key"
}

Limites de taxa

Para garantir a qualidade do serviço, os seguintes limites de taxa se aplicam:

  • 5 requisições por segundo
  • 100 requisições por minuto
  • 1000 requisições por hora