API do painel: como automatizar os pedidos da sua revenda

Quando a revenda cresce, fazer cada pedido à mão vira gargalo: o cliente paga, você copia o link, escolhe o serviço, digita a quantidade... e repete isso dezenas de vezes por dia. A API do painel resolve: ela permite que a sua loja, o seu site ou o seu próprio painel façam os pedidos automaticamente, sem você no meio.

O que é uma API, em português claro

API é uma porta de comunicação entre sistemas. Em vez de você entrar no painel e clicar, o seu sistema "conversa" diretamente com o painel e pede: "faça um pedido deste serviço, para este link, nesta quantidade". O painel responde com o número do pedido e, depois, com o status dele.

Na prática, isso permite que um cliente compre no seu site e o pedido seja feito no painel no mesmo instante, a qualquer hora — inclusive de madrugada.

Quando vale a pena usar

Situação	Vale usar a API?
Poucos pedidos por dia, atendidos pelo WhatsApp	Ainda não: o painel resolve bem.
Muitos pedidos por dia e tempo gasto digitando	Sim: a automação libera o seu tempo.
Você tem (ou quer ter) um site ou loja virtual	Sim: os pedidos saem sozinhos depois do pagamento.
Você tem o seu próprio painel para revender	Sim: é a forma padrão de conectar fornecedores.

Onde encontrar a sua chave

Tudo o que você precisa está na página API, no menu do painel: o endereço da API, a sua chave pessoal e a documentação com exemplos. A chave identifica a sua conta — os pedidos feitos com ela usam o seu saldo.

As ações que a API oferece

Todas as chamadas são feitas por POST para o endereço da API mostrado na página, sempre com a sua key e uma action:

Ação (action)	Para que serve
services	Lista os serviços disponíveis, com ID, preço por 1.000 e limites.
add	Cria um pedido: informe service, link e quantity.
status	Consulta a situação de um pedido pelo número (order).
refill	Pede a reposição de um pedido, nos serviços que oferecem.
refill_status	Consulta a situação de uma reposição.
balance	Mostra o seu saldo atual.

Um exemplo de pedido

Veja como seria um pedido feito pela linha de comando com curl. Troque os valores entre colchetes pelos seus:

curl -X POST [endereço da API] \
  -d "key=[sua chave]" \
  -d "action=add" \
  -d "service=[ID do serviço]" \
  -d "link=https://instagram.com/[perfil]" \
  -d "quantity=1000"

Se tudo der certo, a resposta traz o número do pedido. Com esse número, você consulta o andamento usando a ação status — a resposta informa a situação, quanto já foi entregue e quanto falta.

Como montar um fluxo automático

1. Sincronize os serviços. Use a ação services para trazer a lista e escolher quais vai oferecer, com o seu preço de venda.
2. Receba o pagamento. Na sua loja ou site, o pedido só segue depois que o pagamento é confirmado.
3. Crie o pedido. Com o pagamento confirmado, o sistema chama a ação add e guarda o número do pedido.
4. Acompanhe o status. De tempos em tempos, o sistema consulta o status e atualiza o cliente.
5. Monitore o saldo. Use a ação balance para ser avisado antes de o saldo acabar.

Cuidados que evitam dor de cabeça

• Valide o link antes de enviar. Um link errado vira pedido errado, igual no painel.
• Respeite os limites de cada serviço. Quantidades fora do mínimo e do máximo são recusadas.
• Mantenha saldo de reserva. Sem saldo, os pedidos automáticos falham e o cliente fica esperando.
• Revise os preços. Se o custo de um serviço mudar, atualize o preço de venda na sua loja.