Documentação da API

No padrão dos painéis SMM: um endpoint, a ação no campo action e a sua chave. A chave é gerada na página API do painel, depois do cadastro.

Endpoint base
https://smmpix.com/api/v2
POST

1. Criar pedido

Cria um novo pedido usando seu saldo disponível. O valor é debitado na hora; se o pedido falhar depois, o estorno é automático.

/api/v2
{
  "key": "sua_chave_api_aqui",
  "action": "add",
  "service": 1041,
  "link": "https://instagram.com/p/...",
  "quantity": 1000
}
Resposta
{ "order": "7b43k6tk-gLSJ-975r-tpoH-2YH8tA36ggPL" }

// ATENÇÃO: o id do pedido é uma STRING (UUID), não um número.
// Guarde-o como texto — converter para inteiro perde o valor.
POST

2. Status do pedido

Verifica o status e o progresso de um pedido. Use o `order` exatamente como veio na resposta do `add`: é uma string.

/api/v2
{
  "key": "sua_chave_api_aqui",
  "action": "status",
  "order": "7b43k6tk-gLSJ-975r-tpoH-2YH8tA36ggPL"
}
Resposta
{
  "charge": "16.5000",
  "start_count": "0",
  "status": "In progress",
  "remains": "850",
  "currency": "BRL"
}
POST

3. Status de vários pedidos

Mesma ação `status`, com `orders` (plural) e até 100 ids separados por vírgula. É a forma certa de sincronizar uma carteira inteira sem estourar o limite da sua chave. A resposta é indexada pelo id; um id que não seja seu volta como erro na posição dele.

/api/v2
{
  "key": "sua_chave_api_aqui",
  "action": "status",
  "orders": "7b43k6tk-gLSJ-...,9af21c30-77bd-..."
}
Resposta
{
  "7b43k6tk-gLSJ-...": {
    "charge": "16.5000", "start_count": "0",
    "status": "In progress", "remains": "850", "currency": "BRL"
  },
  "9af21c30-77bd-...": { "error": "Pedido não encontrado." }
}
POST

4. Reposição (refill)

Pede ao provedor a reposição de um pedido CONCLUÍDO, para quando a entrega cai depois de completa. Só vale para serviços com `refill: true`, dentro de 30 dias da conclusão, e uma a cada 24 horas por pedido. Guarde o id devolvido: `refill_status` consulta a reposição mais recente do pedido, e um id anterior deixa de ser encontrado quando uma nova é pedida.

/api/v2
{
  "key": "sua_chave_api_aqui",
  "action": "refill",
  "order": "7b43k6tk-gLSJ-975r-tpoH-2YH8tA36ggPL"
}

// Vários de uma vez (até 10): use "orders" e receba um array.
{ "key": "...", "action": "refill", "orders": "id1,id2" }
Resposta
{ "refill": "RF-77" }

// com "orders":
[ { "order": "id1", "refill": "RF-77" },
  { "order": "id2", "refill": { "error": "Este serviço não oferece reposição.",
                                "error_code": "REFILL_NOT_AVAILABLE" } } ]
POST

5. Status da reposição

Consulta o andamento de uma reposição já solicitada, pelo id devolvido por `refill`. Para várias de uma vez (até 10), use `refills` e receba um array.

/api/v2
{
  "key": "sua_chave_api_aqui",
  "action": "refill_status",
  "refill": "RF-77"
}

// Várias de uma vez:
{ "key": "...", "action": "refill_status", "refills": "RF-77,RF-80" }
Resposta
{ "status": "Completed" }

// com "refills":
[ { "refill": "RF-77", "status": "Completed" },
  { "refill": "RF-80", "status": { "error": "Reposição não encontrada.",
                                    "error_code": "REFILL_NOT_FOUND" } } ]
POST

6. Cancelar pedido

Cancela um pedido que ainda não terminou e devolve ao seu saldo o que não foi entregue. Se o pedido já foi para o provedor, o cancelamento depende da confirmação dele. Até 10 ids por chamada; a resposta é sempre um array.

/api/v2
{
  "key": "sua_chave_api_aqui",
  "action": "cancel",
  "orders": "7b43k6tk-gLSJ-975r-tpoH-2YH8tA36ggPL"
}
Resposta
[ { "order": "7b43k6tk-gLSJ-...", "cancel": 1 } ]

// recusa:
[ { "order": "...", "cancel": { "error": "Só dá para cancelar um pedido que ainda não terminou.",
                                "error_code": "CANCEL_NOT_AVAILABLE" } } ]
POST

7. Consultar saldo

Retorna o saldo atual da sua conta.

/api/v2
{
  "key": "sua_chave_api_aqui",
  "action": "balance"
}
Resposta
{ "balance": "496.8800", "currency": "BRL" }
POST

8. Listar serviços

Retorna todos os serviços disponíveis com seus IDs e preços. O campo `service` de cada item é o ID que você usa em `add`, o mesmo número exibido na coluna ID do catálogo. O `rate` já sai com o desconto da sua conta, quando houver, e é o valor cobrado em `add`. O campo `type` diz quais parâmetros aquele serviço exige em `add` (ver abaixo). A mesma lista, em planilha, está no botão de download da tela Serviços.

/api/v2
{
  "key": "sua_chave_api_aqui",
  "action": "services"
}
Resposta
[
  {
    "service": 99003,
    "name": "Instagram Curtidas",
    "type": "Default",
    "category": "Instagram — Curtidas",
    "rate": "16.5000",   // por 1000, em BRL
    "min": "50",
    "max": "20000",
    "refill": false,
    "cancel": true
  }
]
POST

9. Pedido com parâmetros por tipo

Serviços que não são do tipo "Default" pedem campos adicionais, com os mesmos nomes do padrão de mercado. Em "Custom Comments" e "Package" a quantidade não é enviada: ela vem da lista ou do tamanho do pacote. Confira o campo `type` do serviço em `action: services`.

/api/v2
// type: "Custom Comments" — sem quantity
{
  "key": "sua_chave_api_aqui",
  "action": "add",
  "service": 1042,
  "link": "https://instagram.com/p/...",
  "comments": "primeiro comentário\nsegundo comentário"
}

// type: "Mentions" | "SEO" | "Poll" | "Web Traffic" ...
// usernames / keywords / answer_number / country+device+type_of_traffic

// type: "Package" — só o link
{ "key": "...", "action": "add", "service": 1043, "link": "https://..." }

// Entrega em etapas: só onde action=services traz "dripfeed": true.
// quantity é POR ETAPA; o débito é quantity × runs. interval em minutos.
{ "key": "...", "action": "add", "service": 1044, "link": "https://...",
  "quantity": 200, "runs": 5, "interval": 30 }

Formato de erro

Toda falha responde com HTTP 200, como manda o padrão do mercado. Confira error antes de ler qualquer outro campo; não se guie pelo código HTTP. As duas exceções são 429 (excedeu o limite de requisições: espere) e 500 (falha nossa: pode repetir depois).

Para o seu código decidir o que fazer, use error_code, que não muda, e não o texto de error. retryable: true quer dizer que repetir a mesma requisição mais tarde pode dar certo.

{ "error": "Saldo insuficiente.", "error_code": "INSUFFICIENT_BALANCE", "retryable": false }

INVALID_KEY           chave errada ou revogada
INVALID_ACTION        action desconhecida
INVALID_PARAMETER     parâmetro faltando ou fora da regra
TOO_MANY_IDS          lote acima do teto
SERVICE_NOT_FOUND     service não existe ou saiu do catálogo
SERVICE_UNAVAILABLE   serviço pausado no momento
MINIMUM_ORDER_AMOUNT  pedido abaixo do valor mínimo
INSUFFICIENT_BALANCE  saldo menor que o pedido
LINK_BUSY             já há pedido em andamento neste link (retryable)
ORDER_NOT_FOUND       pedido não é seu ou não existe
REFILL_NOT_FOUND      reposição não é sua ou não existe
REFILL_NOT_AVAILABLE  reposição não cabe neste pedido agora
CANCEL_NOT_AVAILABLE  cancelamento não cabe neste pedido
RATE_LIMITED          limite de requisições (HTTP 429, retryable)
PROVIDER_ERROR        falha temporária ao falar com o provedor (retryable)
INTERNAL_ERROR        falha nossa (HTTP 500, retryable)

Formato da requisição

Aceitamos JSON (Content-Type: application/json) e form-urlencoded, que é o formato usado pela maioria dos painéis. Todas as ações ficam no mesmo endpoint; o que muda é o campo action.

GET com os parâmetros na query string também funciona, para painéis que só sabem falar assim. Prefira POST: numa URL, a sua chave fica gravada em log de acesso (nosso e de qualquer proxy no caminho). Se precisar usar GET, trate a chave como exposta e troque ela periodicamente. Dá para manter várias chaves e revogar uma sem derrubar as outras.

Limite de requisições

Cada chave aceita 600 requisições por minuto. Há também um limite de 1.200 por minuto por IP de origem, somando todas as chaves que saem do mesmo servidor.

Ao estourar, a resposta é 429 com o cabeçalho Retry-After: os segundos que faltam para liberar. Para acompanhar muitos pedidos, use status com orders (até 100 por chamada) em vez de um pedido por vez.

Evitar pedido duplicado

Se a conexão cair depois de enviar um add, você não sabe se o pedido entrou. Mande request_id junto (também aceitamos idempotencyKey): reenviar com o mesmo valor devolve o pedido já criado em vez de cobrar de novo. Pode ser o id do pedido no seu painel, até 128 caracteres, sem espaço.

{ "key": "...", "action": "add", "service": 1041,
  "link": "https://...", "quantity": 1000,
  "request_id": "48213" }

Exemplo em PHP

Um cliente pronto para colar no seu painel. Precisa de PHP 7.4 ou mais novo com a extensão curl.

smmpix-api.php
<?php
// Cliente da API do SMMPix. PHP 7.4+ com a extensão curl.
class SmmpixApi
{
    private $url = 'https://smmpix.com/api/v2';
    private $key;

    public function __construct(string $key)
    {
        $this->key = $key;
    }

    private function call(array $params): array
    {
        $ch = curl_init($this->url);
        curl_setopt_array($ch, [
            CURLOPT_POST => true,
            CURLOPT_POSTFIELDS => http_build_query(['key' => $this->key] + $params),
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_TIMEOUT => 30,
        ]);
        $body = curl_exec($ch);
        $http = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
        $netError = curl_error($ch);
        curl_close($ch);

        if ($body === false) {
            throw new RuntimeException('Falha de rede: ' . $netError);
        }
        if ($http === 429) {
            throw new RuntimeException('Limite de requisicoes. Espere 60 segundos.');
        }
        $data = json_decode($body, true);
        if (!is_array($data)) {
            throw new RuntimeException('Resposta inesperada (HTTP ' . $http . ')');
        }
        // Falha vem com HTTP 200: confira "error" antes de qualquer campo.
        if (isset($data['error'])) {
            throw new RuntimeException($data['error']);
        }
        return $data;
    }

    public function services(): array
    {
        return $this->call(['action' => 'services']);
    }

    public function balance(): array
    {
        return $this->call(['action' => 'balance']);
    }

    // $idempotencyKey: um id SEU, unico por pedido (ex.: o id do pedido no
    // seu painel). Reenviar com o mesmo valor devolve o pedido ja criado.
    public function add(int $service, string $link, int $quantity, string $idempotencyKey): string
    {
        $r = $this->call([
            'action' => 'add',
            'service' => $service,
            'link' => $link,
            'quantity' => $quantity,
            'idempotencyKey' => $idempotencyKey,
        ]);
        return (string) $r['order']; // UUID: guarde como TEXTO
    }

    public function status(string $order): array
    {
        return $this->call(['action' => 'status', 'order' => $order]);
    }

    // Ate 100 ids por chamada. Resposta indexada pelo id.
    public function multiStatus(array $orders): array
    {
        return $this->call(['action' => 'status', 'orders' => implode(',', $orders)]);
    }
}

// Uso
$api = new SmmpixApi('sua_chave_api_aqui');
try {
    $saldo = $api->balance();
    echo 'Saldo: ' . $saldo['balance'] . ' ' . $saldo['currency'] . PHP_EOL;
} catch (RuntimeException $e) {
    echo 'Erro: ' . $e->getMessage() . PHP_EOL;
}
Ações disponíveis: services, balance, add, status, refill, refill_status e cancel. Consultar status aceita até 100 pedidos por chamada; as ações que mudam o pedido (refill e cancel) aceitam até 10, porque cada uma vira uma chamada ao provedor. refill e cancel só valem nos serviços que trazem refill: true / cancel: true em action: services.
Precisa de ajuda com a integração? Abra um ticket em Suporte com o endpoint e o corpo da requisição que você está usando.