Proxy residencial
Atualizado:
Gerencie pacotes, listas e sessões de proxies residenciais programaticamente.
Um pacote é a sua assinatura residencial — ele tem um limite de tráfego e uma data de validade. Dentro de um pacote, você cria listas: conjuntos nomeados de IPs filtrados por localização geográfica (GEO) e regras de rotação. Você se conecta ao proxy usando o login e a senha da lista, e um pacote pode conter várias listas para diferentes casos de uso.
Listas
criar, configurar e remover listas de proxy
Leia
Escreva
Pacote
Mais controles
Comum a todos os terminais residenciais
URL base
https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/Autenticação
Chave de API no caminho da URL — nunca registre URLs completas de solicitações.
Modelo de erros
Erros de negócios retornam HTTP 200 com o campo errors[] preenchido.
Depois de configurar seus proxies
Cases (FAQ)common scenarios and troubleshootingOpenBalancecheck funds before extending trafficOpenPerguntas frequentes
Pacote — sua assinatura (limite de tráfego + validade). Lista — um pacote de login/senha com filtros geográficos e de lista de permissões que fica dentro de um pacote. Sessão — vinculação de curta duração de um IP de saída específico a uma única conexão, formada dinamicamente por meio de _s_… sufixo no login.
No nível do pacote. Uma lista consiste apenas em credenciais e um filtro; consumption-cost os dados são agregados por login (ou seja, por lista), mas os débitos efetivos são contabilizados no pool do pacote.
Cada porta fornece um IP de saída independente — use-os em paralelo para solicitações simultâneas. Uma porta = um IP de saída em um determinado momento.
Uma lista dentro do seu pacote principal fornece um pacote de credenciais/filtros — mas o tráfego dele compartilha o pool do pacote sem limite. Um subpacote reserva uma fatia fixa de tráfego (traffic_limit) com seu próprio prazo de validade e botão de ativação/desativação, devolvendo o tráfego não utilizado ao pacote pai quando excluído. As listas que você criar nele funcionam da mesma maneira — elas são cobradas apenas com base na parcela do subpacote.
Use um subpacote quando precisar de um limite rígido de tráfego para alguém (um cliente, uma equipe, uma campanha) — sem precisar revelar sua chave de API. Todo o gerenciamento continua sendo feito por meio da sua própria chave. Use uma lista simples quando precisar apenas de isolamento de credenciais ou geográfico dentro da sua própria cota.
Sim: https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/.... As variantes de subusuários usam /residentsubuser/....
HTTP e SOCKS5 no mesmo IP.
A renovação programática de um pacote residencial não está prevista na API pública. /extend-proxies (/prolong/calc/{type}, /prolong/make/{type}) aceita apenas tipos baseados em IP — ipv4, ipv6, mobile, isp, mix, mix_isp. resident não está nessa lista e não há /resident/prolong endpoint.
Renove o pacote residencial pelo painel de controle antes de expired_at relatado por get-package-information. O comportamento exato no vencimento (conexões ativas, transferência de tráfego não utilizado) não está documentado nas especificações da API — verifique com o suporte se isso for relevante para sua integração.