Conexión y cambio de IP

Las primeras secciones tratan de Residential. Las direcciones fijas se conectan de otra forma: sección aparte más abajo.

Línea de conexión

La respuesta de POST /api/v1/packages/{id}/proxies trae host, port, username, password.

El usuario es una cadena lista: la segmentación y el modo están codificados en ella, no puede armarla usted mismo.

El puerto codifica el modo y el protocolo; no se puede cambiar.

residential.ipv.rent:10000:USERNAME:PASSWORD          # navegadores antidetección, gestores de proxies
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 y protocolos

Modo	Comportamiento
`rotating`	dirección nueva en cada conexión
`sticky`	la dirección se mantiene `ttl_minutes`: 3..1440, por defecto 60

El puerto de cada par (modo, protocolo) llega en connection_options de la ficha del paquete:

Modo	HTTP	SOCKS5
`rotating`	9000	11000
`sticky`	10000	12000

Los protocolos de correo (SMTP, IMAP, POP3) y UDP no son compatibles.

Segmentación

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

Los valores son códigos del catálogo geográfico.

Los niveles son opcionales: sin geo, el pool global.
state, city y asn requieren country.
Por debajo del país, la segmentación se cumple según disponibilidad: si en la región, la ciudad o el operador solicitados no hay direcciones libres, la salida se da desde otra ubicación del mismo país.

Un valor fuera del catálogo, una clave desconocida o una restricción sin país dan 422 invalid_targeting con field y value.

Cambio de IP

En el modo rotating la dirección cambia sola.

Cada línea sticky tiene su propio enlace rotation_url: un GET a él libera la dirección actual, y la siguiente conexión recibirá otra. No requiere autorización.

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

HTTP	`status`	Significado
200	`ok`	la dirección se liberó
200	`not_in_use`	no hay sesión activa; la siguiente conexión dará igualmente una dirección nueva
200	`unconfirmed`	la solicitud se envió, sin confirmación
404	`not_found`	el enlace no es válido
410	`expired`	el recurso del enlace venció; no ocurre en paquetes de tráfico
429	`rate_limited`	demasiado frecuente
503	`error`	no se pudo cambiar la dirección

Límites: 20 solicitudes por minuto por dirección, 120 por paquete, 300 por IP de quien llama. No se puede revocar un solo enlace: POST /api/v1/packages/{id}/rotation-secret los anula todos a la vez.

Direcciones fijas

Un paquete IPv4 es una lista de direcciones lista para usar. No hace falta armar líneas: todo está en la ficha GET /api/v1/packages/{id}.

Qué	Dónde obtenerlo
direcciones	`addresses[].host`
puerto HTTP	`addresses[].port_http`
puerto SOCKS5	`addresses[].port_socks`
usuario y contraseña	`credentials`: los mismos para todas las direcciones del paquete

198.51.100.11:10010:USERNAME:PASSWORD             # navegadores antidetección, gestores de proxies
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

La dirección de salida es la propia dirección de la lista; no cambia durante todo el plazo.
UDP funciona a través de SOCKS5: para juegos, llamadas y servicios sobre QUIC.
No hay segmentación ni enlaces de cambio de IP: el país y la ubicación se eligen al comprar.
Puede obtener direcciones nuevas mediante el reemplazo: de todas las direcciones del paquete a la vez, una vez cada 30 días.
Los protocolos de correo (SMTP, IMAP, POP3) no son compatibles.

Si no funciona

Síntoma	Causa
fallo de autenticación después de armar el conjunto	la contraseña del paquete se regeneró
dejó de funcionar en todos los procesos a la vez	el volumen se agotó, revise `traffic.left_gb`
la dirección no es del geo solicitado	en la ubicación solicitada no hay direcciones libres y se dio otra ubicación del mismo país; el catálogo geográfico marca esos países con `pool: thin`, use un nivel superior
422 `package_unavailable` al armar el conjunto	el paquete aún no se ha entregado (espere `status: active`), `ttl_minutes` está fuera de 3..1440, o el paquete no admite el modo o el protocolo
las direcciones fijas no responden justo después de la compra	la entrega del paquete tarda hasta 2 minutos
todas las direcciones fijas dejaron de responder a la vez	el plazo terminó: `status: expired`, prolongue el paquete
fallo de autenticación en las direcciones fijas	la contraseña se regeneró, o el paquete se prolongó después de terminar el plazo y se emitió una contraseña nueva: tome `credentials` de la ficha
las direcciones fijas anteriores no funcionan	las direcciones se reemplazaron: `replacement.state: done`, las nuevas están en `addresses`