O envio de pedidos é a operação central da API. O fluxo é simples, mas alguns cuidados fazem a diferença entre uma integração estável e uma fonte de dor de cabeça.

O fluxo básico

1. Identifique o serviço: cada serviço da plataforma possui um código identificador, listado na documentação da página API do painel. É esse código que a requisição usa;
2. Monte a requisição: informe a sua chave, o código do serviço, o link (ou usuário, conforme o serviço) e a quantidade desejada;
3. Envie e guarde a resposta: a API retorna o número do pedido criado. Armazene esse número no seu sistema, pois é com ele que você consulta o andamento depois.

Validações que o seu sistema deve fazer antes de enviar

A API aplica as mesmas regras do painel, então antecipe as validações do seu lado para evitar pedidos recusados:

• Formato do link: respeite o formato de cada serviço (apenas o usuário para seguidores no Instagram, link completo para curtidas, e assim por diante). Remova espaços antes e depois;
• Quantidade dentro da faixa: confira o mínimo e o máximo do serviço antes de enviar;
• Saldo suficiente: consulte o saldo antes de lotes grandes de pedidos, para não receber recusas no meio do processamento;
• Pedido duplicado: não envie novo pedido para um link que já tem pedido em andamento.

Trate a resposta sempre

Nunca assuma que o pedido entrou: verifique a resposta da API. Se veio o número do pedido, registre e siga. Se veio mensagem de erro, registre o motivo e trate conforme o caso (corrigir o link, aguardar saldo, evitar duplicidade).

Dica de arquitetura

Para volume alto, processe os pedidos em fila no seu sistema, um por vez ou em pequenos lotes, em vez de disparar centenas de requisições simultâneas. Sua integração fica mais previsível e o diagnóstico de qualquer problema, muito mais simples.