Ir al contenido principal

Configurar una subcuenta residencial

Crea un paquete de subusuario con su propio límite de tráfico y listas (escenario de revendedor) a través de la API.

Esta guía muestra cómo crear un paquete de subusuario con su propio límite de tráfico y listas, útil para revender.

Cada solicitud usa tu clave API personal del panel de tu cuenta (cómo obtener tu clave API). En los ejemplos siguientes, reemplaza YOUR_API_KEY por tu propia clave. Para pagar con el saldo de tu cuenta, usa paymentId = 1.

Paso 1 — Crea el paquete de subusuario

Crea el paquete de subusuario con límite de tráfico, rotación y caducidad. Copia el package_key de la respuesta.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/create

Cuerpo de la solicitud

Nombre

Tipo

Descripción

traffic_limit

String

Límite de tráfico en bytes.

rotation

Number

Rotación: -1 = sticky, 0 = por solicitud, 1..3600 = segundos.

expired_at

String

Fecha de caducidad del paquete.

is_link_date

Boolean

Booleano: vincular la caducidad al paquete principal.

Respuesta

{
  "status": "success",
  "data": {
    "package_key": "ab12cd34ef56",
    "rotation": 60,
    "traffic_limit": "1073741824",
    "is_active": true
  },
  "errors": []
}

Paso 2 — Crea una lista de IP en el paquete

Crea una lista de IP en ese paquete usando el package_key y la configuración geo, export y rotation.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/add

Cuerpo de la solicitud

Nombre

Tipo

Descripción

package_key

String

Clave del paquete (de la información del paquete).

title

String

Nombre de la lista.

geo

object

Objeto con country, region, city, isp de la base GEO (distingue mayúsculas).

export

object

Objeto: ports (número de IP, máx. 1000) y ext (formato de exportación).

rotation

Number

Rotación: -1 = sticky, 0 = por solicitud, 1..3600 = segundos.

Respuesta

{
  "status": "success",
  "data": {
    "id": 561,
    "title": "US Washington Garfield FIRST-STEP",
    "login": "3c8aa1d4",
    "password": "AZT62Dx3",
    "geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
    "export": { "ports": 10000, "ext": "txt" }
  },
  "errors": []
}

Paso 3 — Confirma el paquete

Lista los paquetes de subusuario para confirmar que todo está configurado correctamente.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/packages

Respuesta

{
  "status": "success",
  "data": [
    { "package_key": "ab12cd34ef56", "traffic_limit": "1073741824", "is_active": true, "expired_at": "d.m.Y" }
  ],
  "errors": []
}

Referencia completa de la API

¿Ha quedado contestada tu pregunta?