Proxy residencial
Actualizado:
Gestionar paquetes, listas y sesiones de proxies residenciales mediante programación.
Un paquete es tu suscripción de uso doméstico: tiene un límite de tráfico y una fecha de caducidad. Dentro de un paquete se crean listas: conjuntos de direcciones IP con nombre, filtrados por ubicación geográfica y reglas de rotación. Te conectas al proxy mediante el nombre de usuario y la contraseña de la lista, y un paquete puede contener muchas listas para diferentes casos de uso.
Listas
crear, configurar y eliminar listas de proxies
Leer
Escribe
Paquete
Más controles
Común a todos los puntos finales residenciales
URL base
https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/Autenticación
Clave API en la ruta de la URL: nunca registres las URL completas de las solicitudes.
Modelo de errores
Los errores de negocio devuelven un código HTTP 200 con el campo «errors[]» rellenado.
Una vez que hayas configurado tus proxies
Cases (FAQ)common scenarios and troubleshootingOpenBalancecheck funds before extending trafficOpenPreguntas frecuentes
Paquete — tu suscripción (límite de tráfico + fecha de caducidad). Lista — un conjunto de nombre de usuario y contraseña con filtros geográficos y de lista blanca que se encuentra dentro de un paquete. Sesión — Vinculación de corta duración de una IP de salida específica a una única conexión, establecida sobre la marcha a través de _s_… Sufijo en el nombre de usuario.
A nivel de paquete. Una lista no es más que credenciales y un filtro; consumption-cost Se agrupan por inicio de sesión (es decir, por lista), pero los cargos reales se cargan al fondo común del paquete.
Cada puerto proporciona una IP de salida independiente; utilízalas en paralelo para las solicitudes simultáneas. Un puerto = una IP de salida en un momento dado.
Una lista dentro de tu paquete principal te proporciona un paquete de credenciales/filtro, pero su tráfico comparte el fondo común del paquete sin límite alguno. Un subpaquete reserva una porción fija de tráfico (traffic_limit) con su propio plazo de caducidad y un interruptor de activación/desactivación, devolviendo el tráfico no utilizado al paquete principal al eliminarlo. Las listas que crees en su interior funcionan de la misma manera: simplemente se facturan contra la porción del subpaquete.
Utiliza un subpaquete cuando necesites un límite estricto de tráfico para alguien (un cliente, un equipo, una campaña), sin tener que ceder tu clave de API. Toda la gestión se sigue realizando a través de tu propia clave. Utiliza una lista simple cuando solo necesites aislamiento de credenciales o geográfico dentro de tu propia cuota.
Sí: https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/.... Las variantes de subusuarios utilizan /residentsubuser/....
HTTP y SOCKS5 en la misma IP.
La renovación programática de un paquete residencial no está contemplada en la API pública. /extend-proxies (/prolong/calc/{type}, /prolong/make/{type}) solo admite tipos basados en IP — ipv4, ipv6, mobile, isp, mix, mix_isp. resident no aparece en esa lista y no hay /resident/prolong punto final.
Renueva el paquete residencial a través del panel de control antes de expired_at informado por get-package-information. El comportamiento exacto al vencimiento (conexiones activas, traspaso de tráfico no utilizado) no está documentado en las especificaciones de la API; consulta con el servicio de asistencia si es relevante para tu integración.