Proxy-seller

Subcontas (subusuários)

Atualizado:

Crie pacotes de subusuários e gerencie suas listas — sem compartilhar suas credenciais principais.

A pacote subuser é uma assinatura secundária derivada do seu pacote residencial principal. Você aloca uma parcela de tráfego e um período de validade para ela, e o subusuário gerencia suas próprias listas dentro dela.

Use isso para revendedores, membros da equipe ou ambientes de cliente isolados. O tráfego utilizado no subpacote é reservado da sua cota principal; ao ser excluído, o tráfego não utilizado retorna ao pacote pai.

Pacote de subusuário

criar, configurar e remover subpacotes

Leia

GET/residentsubuser/packages
Obter informações sobre o pacote
Todos os pacotes de subusuários com limites de tráfego, validade e chaves de pacote.

Escreva

POST/residentsubuser/create
Criar pacote de subusuário
Reserve tráfego e um período de validade da sua tarifa principal para um novo subpacote.
POST/residentsubuser/update
Atualizar pacote
Ajuste a alocação, a rotação ou a validade do tráfego. O tráfego não utilizado permanece no subpacote.
DELETE/residentsubuser/delete
Excluir o pacote do subusuário
Remova o subpacote. Qualquer tráfego não utilizado volta para sua tarifa principal.

Listas no pacote subuser

mesmas operações que as listas residenciais pai, restritas a um subpacote

Leia

GET/residentsubuser/lists
Recupere as listas de IP existentes
Todas as listas em um subpacote. Filtre por `package_key` ou `listId`.

Escreva

POST/residentsubuser/list/add
Criar lista de IPs
Adicione uma lista a um subpacote com filtro GEO e método de autenticação.
POST/residentsubuser/list/rename
Renomear lista criada
Altere o nome de exibição da lista dentro de um subpacote.
POST/residentsubuser/list/rotation
Alterar a rotação
Defina como fixo, por solicitação ou com rotação baseada em tempo (1–3.600 segundos).
DELETE/residentsubuser/list/delete
Lista de exclusão
Remova uma lista de um subpacote. As conexões ativas são encerradas em cerca de 60 segundos.

Especial: Lista API-TOOL

DisposiçõesPUT/residentsubuser/list/tools
Uma lista pré-configurada para integrações com o API-TOOL. As listas são criadas com um nome padrão; renomeie-as posteriormente, se necessário.

Comum a todos os endpoints de subcontas

  1. URL base

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

  2. Autenticação

    Chave de API no caminho da URL (sua chave da conta principal, não a do subusuário)

  3. Parâmetro obrigatório

    A maioria dos endpoints exige o `package_key` — obtenha-o em

    GET/pt-BR/residentsubuser/packages

  4. Modelo de erros

    Erros de negócios retornam HTTP 200 com o campo `errors[]` preenchido

Relacionado

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

Perguntas frequentes

Não — a nomenclatura é enganosa. Nesta API, um “subusuário” é um subpacote: uma parte do seu pacote residencial principal com seu próprio traffic_limit, expired_at, is_active botões de alternância e listas.

Tudo /residentsubuser/... pontos finais {YourApiKey} — a sua própria. Não há nenhuma segunda chave de API emitida em nenhuma parte da especificação. As credenciais que seu usuário final recebe são no nível da lista login/password (retornado por /residentsubuser/list/add) — essas são credenciais de conexão para o proxy, não chaves de gerenciamento.

Não. O subusuário vê apenas o seu próprio traffic_limit e consumed. A conta principal tem acesso a ambas as camadas.

Chamar update-package com um aumento traffic_limit. A recarga é aplicada imediatamente.

Não. As listas estão vinculadas ao subpacote em que foram criadas. Recrie a lista no subusuário de destino.

On this page

Pacote de subusuário
Leia
Escreva
Listas no pacote subuser
Leia
Escreva
Especial: Lista API-TOOL
Comum a todos os endpoints de subcontas
1
URL base
2
Autenticação
3
Parâmetro obrigatório
4
Modelo de erros
Relacionado
Perguntas frequentes