Conexão e troca de IP

As primeiras seções tratam do Residential. Os endereços fixos se conectam de outra forma: seção própria abaixo.

Linha de conexão

A resposta de POST /api/v1/packages/{id}/proxies traz host, port, username, password.

O usuário é uma string pronta: a segmentação e o modo estão codificados nele, não o monte por conta própria.

A porta codifica o modo e o protocolo, não a altere.

residential.ipv.rent:10000:USERNAME:PASSWORD          # navegadores antidetect, gerenciadores de proxy
http://USERNAME:[email protected]:10000   # curl, requests, Node, Go
socks5://USERNAME:[email protected]:12000

curl -x 'http://USERNAME:[email protected]:10000' https://api.ipify.org

Modos e protocolos

Modo	Comportamento
rotating	novo endereço a cada conexão
sticky	o endereço é mantido por ttl_minutes: 3..1440, padrão 60

A porta de cada par (modo, protocolo) vem em connection_options da ficha do pacote:

Modo	HTTP	SOCKS5
rotating	9000	11000
sticky	10000	12000

Protocolos de e-mail (SMTP, IMAP, POP3) e UDP não são suportados.

Segmentação

{
  "count": 10,
  "geo": {
    "country": "us",
    "state": "california",
    "city": "los angeles"
  }
}

Os valores são códigos do catálogo geográfico.

• Os níveis são opcionais: sem geo - pool global.
• state, city e asn exigem country.
• Abaixo do país, a segmentação é feita quando possível: se a região, a cidade ou a operadora pedida não tiver endereços livres, a saída vem de outro local do mesmo país.

Valor fora do catálogo, chave desconhecida ou refinamento sem país - 422 invalid_targeting com field e value.

Troca de IP

No modo rotating, o endereço muda sozinho.

Cada linha sticky tem seu próprio link rotation_url: um GET nele libera o endereço atual, e a próxima conexão recebe outro. Não é preciso autorização.

curl -s https://ipv.rent/r/9f3c1e...

HTTP	status	Significado
200	ok	endereço liberado
200	not_in_use	não há sessão ativa; a próxima conexão dará um novo endereço de qualquer forma
200	unconfirmed	pedido enviado, sem confirmação
404	not_found	o link não é válido
410	expired	o recurso do link expirou; não ocorre em pacotes de tráfego
429	rate_limited	frequência alta demais
503	error	não foi possível trocar o endereço

Limites: 20 requisições por minuto por endereço, 120 por pacote, 300 por IP de quem chama. Não é possível revogar um único link - POST /api/v1/packages/{id}/rotation-secret invalida todos de uma vez.

Endereços fixos

Um pacote IPv4 é uma lista pronta de endereços. Não é preciso montar linhas: tudo está na ficha GET /api/v1/packages/{id}.

O quê	Onde encontrar
endereços	addresses[].host
porta HTTP	addresses[].port_http
porta SOCKS5	addresses[].port_socks
usuário e senha	credentials - um único para todos os endereços do pacote

198.51.100.11:10010:USERNAME:PASSWORD             # navegadores antidetect, gerenciadores de proxy
http://USERNAME:[email protected]:10010      # curl, requests, Node, Go
socks5://USERNAME:[email protected]:10011

curl -x 'http://USERNAME:[email protected]:10010' https://api.ipify.org

• O endereço de saída é o próprio endereço da lista, e ele não muda durante todo o período.
• UDP funciona via SOCKS5 - para jogos, chamadas e serviços em QUIC.
• Não há segmentação nem links de troca de IP: país e local são escolhidos na compra.
• Para obter novos endereços, use a substituição - de todos os endereços do pacote de uma vez, a cada 30 dias.
• Protocolos de e-mail (SMTP, IMAP, POP3) não são suportados.

Se não funcionar

Sintoma	Causa
falha de autenticação depois de montar o conjunto	uma nova senha do pacote foi gerada
parou de funcionar em todos os workers ao mesmo tempo	o volume foi consumido, confira traffic.left_gb
endereço fora da geo pedida	o local pedido não tem endereços livres, foi entregue outro local do mesmo país; o catálogo geográfico marca esses países com pool: thin - use um nível acima
422 package_unavailable ao montar o conjunto	o pacote ainda não foi entregue (aguarde status: active), ttl_minutes fora de 3..1440, ou o modo ou o protocolo não é suportado pelo pacote
os endereços fixos não respondem logo após a compra	a entrega do pacote leva até 2 minutos
todos os endereços fixos pararam de responder ao mesmo tempo	o período terminou: status: expired, prolongue o pacote
falha de autenticação nos endereços fixos	uma nova senha foi gerada, ou o pacote foi prolongado após o fim do período e uma nova senha foi emitida - pegue credentials na ficha
os endereços fixos antigos não funcionam	os endereços foram substituídos: replacement.state: done, os novos estão em addresses