Fênix Social API

Integre nossa plataforma de marketing digital diretamente no seu sistema. Crie pedidos, consulte status e gerencie saldo programaticamente.

Autenticação

Todas as requisições precisam de uma chave de API. Gere a sua no painel em Configurações → API.

Passe a chave em toda requisição pelo cabeçalho Authorization:

Via cabeçalho

Authorization: Bearer fsx_sua_chave_aqui

Chaves na URL não são aceitas. Gere uma nova chave após esta atualização; as antigas deixam de funcionar.

Ao criar pedidos, envie também Idempotency-Key com um identificador único de 16 a 100 letras, números, hífens ou sublinhados. Reutilize-o em tentativas do mesmo pedido. Um novo pedido precisa de outra chave.

Erros

Quando algo dá errado, a API retorna um objeto com o campo erro:

{"erro": "Saldo insuficiente. Disponível: R$ 5.00. Necessário: R$ 10.00"}

Listar serviços

Copiar[
  {
    "service": "1234",
    "name": "Instagram Seguidores Brasileiros",
    "category": "Instagram seguidores [Brasil]",
    "type": "Default",
    "billing": "per_1000",
    "rate": 2.50,
    "min": 100,
    "max": 10000,
    "refill": true
  },
  ...
]

Consultar saldo

Copiar{
  "balance": "47.50",
  "currency": "BRL"
}

Criar pedido

Copiar{
  "action": "add",
  "service": "1234",
  "link": "https://instagram.com/seuperfil",
  "quantity": 500
}

Copiar{
  "order": "#00042",
  "status": "executando",
  "charge": "1.25",
  "currency": "BRL"
}

Status do pedido

Copiar{
  "order": "#00042",
  "status": "executando",
  "charge": "1.25",
  "start_count": 1200,
  "remains": 300,
  "currency": "BRL"
}

Exemplos — cURL

Listar serviços

Copiarcurl "https://fenixsocial.site/api/public-api?action=services" \
  -H "Authorization: Bearer fsx_sua_chave_aqui"

Criar pedido

Copiarcurl -X POST "https://fenixsocial.site/api/public-api?action=add" \
  -H "Authorization: Bearer fsx_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido_exemplo_0001" \
  -d '{"action":"add","service":"1234","link":"https://instagram.com/seuperfil","quantity":500}'

Exemplos — JavaScript

Copiarconst API_KEY = 'fsx_sua_chave_aqui';
const BASE = 'https://fenixsocial.site/api/public-api';
const headers = { 'Authorization': `Bearer ${API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': crypto.randomUUID() };

// Listar serviços
const services = await fetch(`${BASE}?action=services`, { headers }).then(r => r.json());

// Criar pedido
const order = await fetch(`${BASE}?action=add`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ action: 'add', service: '1234', link: 'https://instagram.com/perfil', quantity: 500 })
}).then(r => r.json());

console.log(order); // { order: '#00042', status: 'executando', charge: '1.25', currency: 'BRL' }

// Consultar status
const status = await fetch(`${BASE}?action=status&order=${order.order}`, { headers }).then(r => r.json());

Exemplos — Python

Copiarimport requests
import uuid

API_KEY = 'fsx_sua_chave_aqui'
BASE = 'https://fenixsocial.site/api/public-api'
HEADERS = {'Authorization': f'Bearer {API_KEY}', 'Idempotency-Key': str(uuid.uuid4()), 'Content-Type': 'application/json'}

# Listar serviços
services = requests.get(f'{BASE}?action=services', headers=HEADERS).json()

# Criar pedido
order = requests.post(f'{BASE}?action=add', headers=HEADERS, json={
    'action': 'add',
    'service': '1234',
    'link': 'https://instagram.com/seuperfil',
    'quantity': 500
}).json()

print(order)  # {'order': '#00042', 'status': 'executando', 'charge': '1.25', 'currency': 'BRL'}

# Consultar status
status = requests.get(f'{BASE}?action=status&order={order["order"]}', headers=HEADERS).json()