API de proxy: gerencie seus IPs por código

Lista os proxies da conta, paginados. Os campos de credencial (senha, string de conexão) não vêm aqui — só em GET /proxies/{id}.

Detalhe de um proxy, incluindo password e connection_string prontos para colar na sua ferramenta.

Proxy de outra conta ou ID inexistente devolvem a mesma resposta 404 — de propósito, para não confirmar se um ID existe quando não é seu.

Dispara uma conexão HTTPS real pelo proxy e devolve IP de saída, operadora e latência — o mesmo teste do botão “Testar” no painel. O resultado fica registrado no histórico do proxy.

Responde 200 quando o teste passa e 422 quando falha — o corpo muda de formato, não é erro de chamada.

O mesmo fluxo do botão Não funciona no painel: testa o túnel e só pede a troca do IP se a falha for técnica (timeout, host mudo, 407 com a senha do painel). A equipe confirma a troca, sem custo e com o mesmo vencimento; o IP novo aparece em GET /proxies e o dono da conta recebe e-mail. Proxy no ar, verificador fora ou plano por GB não geram troca — a resposta diz o que fazer.

200 quando o diagnóstico conclui (incluindo “está no ar” ou “IP substituído”). 202 quando a falha foi confirmada e a troca está com a equipe (pending_approval; chamar de novo não abre outro pedido). 422 quando não dá para trocar agora. Ban de plataforma continua fora desta rota.

Quando existe pedido de troca, a resposta traz replacement com o id e a situação — acompanhe em GET /replacements/{id}. Opcional: motivo (até 500 caracteres, a equipe lê junto do pedido) e o cabeçalho Idempotency-Key: repetir a chamada com a mesma chave em até 24 horas devolve o mesmo resultado, sem testar nem pedir de novo.

Dois jeitos. Sem corpo: devolve o link de checkout do plano do proxy para você concluir o pagamento. Com {"payment_method": "wallet"}: renova agora, debitando o saldo da carteira, e mantém o mesmo IP.

Opcional: period em meses (padrão 1) e o cabeçalho Idempotency-Key para a nova tentativa não renovar duas vezes. Elegibilidade: proxy ativo, plano à venda, não ser trial e o fornecedor renovar o mesmo IP. Responde 200 quando a extensão sai na hora e 202 quando o fornecedor demora (já pago; termina sozinho). Saldo insuficiente: 402. Renovação deste IP já em andamento: 409, sem nova cobrança. Em plano de lote, renova o lote inteiro.

Liga ou desliga a renovação automática de um IP (em plano de lote, do lote inteiro). Pela API ela é paga com o saldo da carteira: alguns dias antes do vencimento o sistema debita o saldo e estende o mesmo IP. Para desligar a renovação pelo saldo na conta toda, use POST /wallet/auto-renew com {"enabled": false}.

Sem saldo suficiente, nada é cobrado: a conta recebe um e-mail, o IP segue até o vencimento e o sistema tenta de novo no dia seguinte. O campo auto_renew_last_error do proxy mostra o motivo.

Cancela o IP no fim do período: desliga a renovação automática e o IP continua funcionando até expires_at. Depois disso ele vence. Em plano de lote, cancela o lote inteiro (os IPs vêm em lot_proxy_ids).

Sem multa e sem fidelidade. O período já pago não é devolvido proporcionalmente.

Planos que podem ser comprados pela API, com preço por IP (e por país, quando o plano deixa escolher), descontos por volume, períodos que o fornecedor vende agora e se há entrega disponível (available).

Use o sku daqui no POST /orders. Planos por cidade (São Paulo, Niterói, Irecê) têm SKU próprio.

Compra e entrega na mesma chamada. Responde 201 com IP, porta, usuário e senha quando a entrega sai na hora. Se o fornecedor demorar, responde 202 com "status": "processing": o pagamento já foi feito, o sistema segue tentando a entrega sozinho e você consulta GET /orders/{número}.

Mande o cabeçalho Idempotency-Key (ex.: o ID do seu cliente + número do IP). Se a conexão cair e você repetir a chamada com a mesma chave, recebe o mesmo pedido em vez de comprar de novo. No ISP Brasil, para renovação automática, compre 1 IP por chamada. Se o IP entregue não puder renovar mantendo o endereço, a resposta traz warnings e a renovação dele fica desligada. Em lote fechado, quantity é sempre 1.

Situação de um pedido: delivered (IP pronto), processing (pago, entrega em andamento) ou awaiting_payment. Traz os IPs do pedido com a senha.

GET /orders lista os pedidos da conta, paginados (filtro opcional status, per_page até 100).

Saldo atual, se a renovação automática pelo saldo está ligada na conta, limites de depósito e faixas de bônus.

Gera um PIX de depósito e devolve o copia e cola. Quando o PIX é pago o saldo entra sozinho; GET /wallet/deposits/{id} confere na hora.

Lista os números SMS comprados pela conta, paginados, do mais recente para o mais antigo.

Consulta um número específico e atualiza contra o fornecedor na hora — o mesmo polling que a tela do painel faz. Dá para chamar em loop numa automação até status deixar de ser waiting.

Número de outra conta ou ID inexistente devolvem a mesma resposta 404 — de propósito.