Pedir um canal de proxy manualmente pelo painel funciona enquanto você tem uma dezena de canais. Quando a conta chega à casa das centenas e a renovação precisa ser sincronizada com o gasto do orçamento, o modo manual quebra — e é aí que entra a API. Vamos ver o ciclo típico de emissão e renovação de um canal, a diferença entre endereço dedicado e pacote de tráfego, e o que fazer quando não há estoque no país de que você precisa.

Ciclo típico: do catálogo à renovação

O trabalho com a API de proxy segue o mesmo esquema, independentemente do tipo de canal. Primeiro você consulta o catálogo: a lista de tipos disponíveis, países e preços atuais — ela mostra o que realmente há em estoque antes de você fazer o pedido. Em seguida vem o pedido de um canal específico, indicando o tipo e o país, e a API responde com as credenciais de conexão — endereço, porta, login e senha, que já podem ser colocados direto no seu fluxo de trabalho. Enquanto o canal está ativo, o estado dele é acompanhado por uma consulta separada: o saldo de tráfego nos planos por pacote ou o prazo de validade no caso do endereço dedicado. O ciclo termina com a renovação, se o recurso ainda for necessário, ou com o cancelamento do canal, se a tarefa foi concluída e não faz sentido pagar por um canal parado.

Endereço dedicado x pacote de gigabytes

Um endereço dedicado de datacenter ou ISP é cobrado por mês: você paga um preço fixo pelo período, o endereço fica com você durante todo o período pago, e a renovação é simplesmente um novo pagamento por um novo período. Os canais residenciais e móveis funcionam de outra forma: a cobrança é por gigabyte, e o endereço é entregue por sessão — a cada nova requisição ou ao fim do tempo limite da sessão, o sistema pode entregar outro IP do pool. Essa diferença importa na hora de integrar: um código que mantém o mesmo endereço em uma variável durante todo o script quebra nos canais por sessão e precisa pedir um novo endereço a cada nova sessão. Uma análise detalhada de quando compensa mais um tipo ou o outro está no artigo proxies móveis versus residenciais.

Como consultar o consumo de tráfego sem sobrecarregar

O consumo de tráfego nos canais por pacote não muda instantaneamente após cada requisição — os dados são sincronizados com atraso, e consultar o endpoint de consumo a cada segundo não traz números mais recentes, só gasta o limite de requisições. Uma prática sensata é verificar o saldo a cada poucos minutos ou vincular a verificação ao fim de um grande bloco de tarefas, e não a cada requisição individual feita pelo proxy. O mesmo princípio do intervalo razoável vale para outras partes do catálogo — por exemplo, na configuração da rotação de IP pela API: consultar com muita frequência não acelera o resultado, apenas gasta o limite.

Quando não há estoque no país de que você precisa

O catálogo retorna de forma explícita o status de falta de estoque para um país e tipo de canal específicos, e não um timeout ou um erro genérico — isso permite tratar a situação no código, em vez de ficar tentando adivinhar o que deu errado. Há três opções viáveis: esperar e repetir a requisição mais tarde, se o pool é reabastecido com regularidade; trocar para um país vizinho da mesma região, se a geolocalização não for crítica; ou perguntar ao suporte, por meio de um ticket, o prazo previsto de reposição para aquele destino específico. Prever na automação apenas o cenário normal, sem tratar o estoque vazio, é uma causa frequente de o script falhar em produção em vez de passar com tranquilidade para uma alternativa.

Armazenamento e rotação das credenciais emitidas

As credenciais de conexão — endereço, porta, login e senha — devem ser guardadas como qualquer segredo: em variáveis de ambiente ou em um gerenciador de segredos, e não no código do script. O provedor não troca automaticamente, em segundo plano, o login e a senha do canal, por isso a rotação é responsabilidade do cliente: se houver suspeita de vazamento das credenciais, o melhor é pedir o canal novamente, e não tentar trocar a senha de um recurso já emitido. A lista completa dos canais ativos, o status deles e as credenciais podem ser conferidos no painel — ali também dá para ver quais recursos estão perto de expirar e precisam de renovação.

Perguntas frequentes

Dá para receber as credenciais logo depois do pedido, sem esperar?

Sim, a API retorna as credenciais de conexão de forma síncrona, na resposta à requisição de pedido — para proxies não existe uma etapa separada de ativação que exija consultas repetidas, ao contrário das ativações por e-mail, em que é preciso esperar a chegada da mensagem.

O que acontece com o canal se eu não renová-lo a tempo?

O endereço dedicado, ao fim do período pago, é liberado e pode ser entregue a outro cliente, por isso vale planejar a renovação com antecedência. Os canais por pacote simplesmente deixam de responder quando o tráfego acaba ou o período de cobrança termina, sem multas nem bloqueio da conta.

É preciso avisar a API sobre a desistência do canal ou basta parar de usá-lo?

É melhor chamar explicitamente o cancelamento do canal pela API: isso libera o recurso na hora, e não só ao fim do prazo, e interrompe a cobrança se o plano previr renovação automática.

A descrição completa dos métodos de pedido, renovação e monitoramento está na documentação técnica da API. Os tipos e países atuais estão na seção de proxies.