Proxy-seller

Subcuentas (subusuarios)

Actualizado:

Proporciona paquetes de subusuarios y gestiona sus listas, sin compartir tus credenciales principales.

A paquete subuser Es una suscripción secundaria derivada de tu paquete residencial principal. Le asignas una parte del tráfico y un periodo de validez, y el subusuario gestiona sus propias listas dentro de ella.

Utilízalo para revendedores, miembros del equipo o entornos de cliente aislados. El tráfico consumido en el subpaquete se deduce de tu cuota principal; al eliminarlo, el tráfico no utilizado se devuelve al paquete principal.

Paquete de subusuario

crear, configurar y eliminar subpaquetes

Leer

GET/residentsubuser/packages
Obtener información del paquete
Todos los paquetes para subusuarios con límites de tráfico, fecha de caducidad y claves de paquete.

Escribe

POST/residentsubuser/create
Crear un paquete de subusuario
Reserva tráfico y un periodo de validez de tu tarifa principal para un nuevo subpaquete.
POST/residentsubuser/update
Paquete de actualización
Ajusta la asignación, la rotación o la validez del tráfico. El tráfico no utilizado permanece en el subpaquete.
DELETE/residentsubuser/delete
Eliminar el paquete del subusuario
Elimina el subpaquete. El tráfico no utilizado se volverá a contabilizar en tu tarifa principal.

Listas en el paquete subuser

Las mismas operaciones que en las listas residenciales principales, limitadas a un subpaquete

Leer

GET/residentsubuser/lists
Recuperar las listas de IP existentes
Todas las listas en un subpaquete. Filtrar por `package_key` o `listId`.

Escribir

POST/residentsubuser/list/add
Crear lista de direcciones IP
Añade una lista a un subpaquete con filtro GEO y método de autenticación.
POST/residentsubuser/list/rename
Renombrar la lista creada
Cambia el nombre que se muestra en la lista dentro de un subpaquete.
POST/residentsubuser/list/rotation
Cambiar rotación
Establece una rotación fija, por solicitud o basada en el tiempo (1–3600 segundos).
DELETE/residentsubuser/list/delete
Lista de elementos a eliminar
Elimina una lista de un subpaquete. Las conexiones activas se interrumpen en unos 60 segundos.

Especial: Lista de API-TOOL

DisposicionesPUT/residentsubuser/list/tools
Una lista preconfigurada para integraciones con API-TOOL. Las listas se crean con un nombre predeterminado; cámbialo más adelante si es necesario.

Común a todos los puntos finales de subcuentas

  1. URL base

    https://proxy-seller.com/personal/api/v2/{YourApiKey}/residentsubuser/

  2. Autenticación

    Clave API en la ruta de la URL (tu clave de cuenta principal, no la del subusuario)

  3. Parámetro obligatorio

    La mayoría de los puntos finales requieren package_key; consíguelo en

    GET/es-ES/residentsubuser/packages

  4. Modelo de errores

    Los errores de negocio devuelven un código HTTP 200 con el campo «errors[]» rellenado

Relacionado

Residential proxysame operations on your main packageOpenSession ID + TTLpin sessions for subuser listsOpenCases (FAQ)common subuser scenariosOpen

Preguntas frecuentes

No, la denominación es engañosa. En esta API, un «subusuario» es un subpaquete: una parte de tu paquete residencial principal con su propio traffic_limit, expired_at, is_active botones de alternancia y listas.

Todo /residentsubuser/... puntos finales {YourApiKey} — la tuya propia. No se emite ninguna segunda clave API en ninguna parte de la especificación. Las credenciales que recibe tu usuario final son a nivel de lista login/password (devuelto por /residentsubuser/list/add) — esas son las credenciales de conexión para el proxy, no claves de administración.

No. El subusuario solo ve su propio traffic_limit y consumed. La cuenta principal ve ambas capas.

Llamada update-package con un aumento de traffic_limit. La recarga se aplica de inmediato.

No. Las listas están vinculadas al subpaquete en el que se crearon. Vuelve a crear la lista en el subusuario de destino.

On this page

Paquete de subusuario
Leer
Escribe
Listas en el paquete subuser
Leer
Escribir
Especial: Lista de API-TOOL
Común a todos los puntos finales de subcuentas
1
URL base
2
Autenticación
3
Parámetro obligatorio
4
Modelo de errores
Relacionado
Preguntas frecuentes