Ir para conteúdo principal

Configurar uma subconta residencial

Crie pela API um pacote de subusuário com seu próprio limite de tráfego e listas (cenário de revenda).

Este guia mostra como criar um pacote de subusuário com seu próprio limite de tráfego e listas — útil para revenda.

Cada requisição usa sua chave de API pessoal do painel da sua conta (como obter sua chave de API). Nos exemplos abaixo, substitua YOUR_API_KEY pela sua própria chave. Para pagar com o saldo da conta, use paymentId = 1.

Passo 1 — Crie o pacote de subusuário

Crie o pacote de subusuário com limite de tráfego, rotação e expiração. Copie o package_key da resposta.

Endpoint

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

Corpo da requisição

Nome

Tipo

Descrição

traffic_limit

String

Limite de tráfego em bytes.

rotation

Number

Rotação: -1 = sticky, 0 = por requisição, 1..3600 = segundos.

expired_at

String

Data de expiração do pacote.

is_link_date

Boolean

Booleano — vincular a expiração ao pacote principal.

Resposta

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

Passo 2 — Crie uma lista de IP no pacote

Crie uma lista de IP nesse pacote usando o package_key e as configurações geo, export e rotation.

Endpoint

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

Corpo da requisição

Nome

Tipo

Descrição

package_key

String

Chave do pacote (das informações do pacote).

title

String

Nome da lista.

geo

object

Objeto com country, region, city, isp da base GEO (diferencia maiúsculas).

export

object

Objeto: ports (número de IPs, máx. 1000) e ext (formato de exportação).

rotation

Number

Rotação: -1 = sticky, 0 = por requisição, 1..3600 = segundos.

Resposta

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

Passo 3 — Confirme o pacote

Liste os pacotes de subusuário para confirmar que tudo está configurado corretamente.

Endpoint

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

Resposta

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

Referência completa da API

Isto respondeu à sua pergunta?