Ir al contenido principal

Gestionar una subcuenta

Actualiza un paquete de subusuario (tráfico / caducidad / activar-desactivar), gestiona sus listas o elimínalo a través de la API.

Esta guía muestra cómo actualizar un paquete de subusuario, gestionar sus listas o eliminarlo.

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 — Lista los paquetes de subusuario

Lista los paquetes de subusuario y copia el package_key con el que vas a trabajar.

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": []
}

Paso 2 — Actualiza el paquete

Actualiza el paquete: cambia el límite de tráfico, la rotación, la caducidad o actívalo/desactívalo con is_active.

Endpoint

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

Cuerpo de la solicitud

Nombre

Tipo

Descripción

package_key

String

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

traffic_limit (opcional)

String

Límite de tráfico en bytes.

rotation (opcional)

Number

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

expired_at (opcional)

String

Fecha de caducidad del paquete.

is_active (opcional)

Boolean

Booleano — true activo, false inactivo (activar/desactivar paquete).

is_link_date (opcional)

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 3 — Gestiona las listas del paquete

Lista las listas del paquete, luego renombra una lista (id + title + package_key) o elimina una por su listId.

Endpoint

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

Respuesta

{
  "status": "success",
  "data": [
    { "id": 7788, "title": "Client A", "login": "x1y2z3", "package_key": "ab12cd34ef56" }
  ],
  "errors": []
}

Endpoint — rename

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

Nombre

Tipo

Descripción

id

Number

ID de la lista.

title

String

El nuevo nombre de la lista.

package_key

String

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

Endpoint — delete list

DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/list/delete

Paso 4 — O elimina todo el paquete

Elimina todo el paquete de subusuario por su package_key. Es irreversible.

Endpoint

DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/residentsubuser/delete

Cuerpo de la solicitud

Nombre

Tipo

Descripción

package_key

String

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

Respuesta

{
  "status": "success",
  "data": { "deleted": true },
  "errors": []
}

Referencia completa de la API

¿Ha quedado contestada tu pregunta?