Proxy-seller

Subcontas (subusuários)

Atualizado:

Provisione pacotes de subusuários e gerencie suas listas, sem compartilhar suas credenciais principais.

Apacote de subusuário é uma assinatura secundária criada a partir de seu pacote residencial principal. Você aloca uma fatia de tráfego e um período de validade a ela, e o subusuário gerencia suas próprias listas dentro dela.

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

Pacote de subusuário

criar, configurar e remover subpacotes

Ler

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

Escrever

POST/residentsubuser/create
Criar pacote de subusuário
Reserve tráfego e um período de validade de sua tarifa principal para um novo subpacote.
POST/residentsubuser/update
Pacote de atualização
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. Todo o tráfego não utilizado retorna à sua tarifa principal.

Listas no pacote de subusuário

as mesmas operações das listas residenciais pai, com escopo para um subpacote

Ler

GET/residentsubuser/lists
Recuperar listas de IPs existentes
Todas as listas em um subpacote. Filtrar por `package_key` ou `listId`.

Escrever

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 a lista criada
Alterar o nome de exibição da lista em um subpacote.
POST/residentsubuser/list/rotation
Alterar a rotação
Defina a rotação fixa, por solicitação ou com base no tempo (1-3600 segundos).
DELETE/residentsubuser/list/delete
Excluir lista
Remover uma lista de um subpacote. As conexões ativas caem em cerca de 60 segundos.

Especial: Lista API-TOOL

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

Comum a todos os pontos de extremidade de subconta

  1. URL de base

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

  2. Autenticação

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

  3. Parâmetro obrigatório

    A maioria dos pontos de extremidade exige package_key - obtenha-a em

    GET/pt-BR/residentsubuser/packages

  4. Modelo de erro

    Os erros de negócios retornam HTTP 200 com erros[] preenchidos

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" é umsubpacote: uma parte de seu pacote residencial principal com seu própriotraffic_limit,expired_at,is_active alternar e listas.

Todos/residentsubuser/... os pontos de extremidade aceitam{YourApiKey} - sua própria. Não há uma segunda chave de API emitida em nenhuma parte da especificação. As credenciais que o usuário final recebe são em nível de listalogin/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ópriotraffic_limit econsumed. A conta principal vê as duas camadas.

Chamadaupdate-package com um aumento detraffic_limit. A recarga é aplicada imediatamente.

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

On this page

Pacote de subusuário
Ler
Escrever
Listas no pacote de subusuário
Ler
Escrever
Especial: Lista API-TOOL
Comum a todos os pontos de extremidade de subconta
1
URL de base
2
Autenticação
3
Parâmetro obrigatório
4
Modelo de erro
Relacionado
PERGUNTAS FREQUENTES