Voltar ao início

Documentação API

Versão API: v2

FoxiGrow fornece uma API padrão de SMM Panel que permite integrar nossos serviços em suas próprias aplicações. Esta documentação cobre todos os endpoints disponíveis e seu uso.

Endpoint API

https://foxigrow.com/api/v2

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

Autenticação

Todas as requisições API requerem autenticação usando sua chave API. Você pode encontrar sua chave API nas configurações da sua conta. Inclua o parâmetro key em cada requisição.

POST https://foxigrow.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

Suporte

Se você tiver alguma dúvida sobre a API, entre em contato com nossa equipe de suporte:

Telegram: @FoxigrowBD