Proxy-seller

Proxies e pedidos

Atualizado:

Permissões: account:read, account:write, faturamento:escrever

Neste grupo

Ferramenta

O que ele faz

list_proxies

🢢 read

Seus proxies ativos de um tipo: IP, portas HTTP/SOCKS, credenciais, país, data de validade, status de renovação automática e comentário.

export_proxies

🢢 read

Exporte os proxies como uma lista pronta para uso, com um proxy por linha.

get_reference

🢢 read

Países disponíveis, períodos de aluguel e pacotes para um tipo de produto.

calc_order_cost

🢢 read

Preço e desconto para um novo pedido, sem que ele seja efetuado.

make_order

💳 pays

Faça um novo pedido de proxy.

list_orders

🢢 read

Seus pedidos, com os mais recentes em primeiro lugar, e os alvos de uso já existentes na conta.

verificar_status_do_pedido

🢢 read

Verifica se as ordens de proxy de um pedido já foram emitidas.

calc_prolong_cost

🢢 read

Preço de renovação para proxies específicos, sem renovação.

make_prolong

💳 pays

Renove as procurações por mais um período.

replace_proxy

🟡 write

Solicite a substituição de proxies que não estejam funcionando.

set_proxy_comment

🟡 write

Defina o mesmo comentário em um ou mais proxies.

list_proxies

🢢 read-only · account:read

Seus proxies ativos de um tipo: IP, portas HTTP/SOCKS, credenciais, país, data de validade, status de renovação automática e comentário. password é retornado mascarado, a menos que você solicite o contrário. Proxies com status: "Ended" são terminando em breve, não expirado — date_end é a data de validade real.

Parâmetro

Tipo

Descrição

type obrigatório

tipo de proxy

Tipo de produto. mix é apenas o pacote IPv4 MIX e mix_isp o pacote ISP MIX — duas listas separadas, portanto, “todos os meus proxies MIX” se refere a ambas. subresident não é servido aqui: use list_resident_subuser_lists

orderId

string | inteiro

Apenas um pedido

country

string

Código Alpha-3, por exemplo: USA

latest

booleano

Apenas as procurações emitidas mais recentemente

ends

booleano

Apenas proxies que expiram em breve

page, per_page

inteiro

Página para retornar (padrão 1) e tamanho da página (padrão 50)

reveal

booleano

Voltar password de forma clara, em vez de ••••. O assistente confirma com você primeiro — veja Senhas de proxy e o provedor de IA

Resultados: {items: [...]} — um objeto por proxy com id, ip, protocol, port_http, port_socks, login, password, country, country_alpha3, date_start, date_end, status, status_type, can_prolong, auto_renew, comment, order_id, order_number, base_order_number. A resposta é dividida em páginas (50 por página por padrão) e contém page, per_page, total, total_pages, além de um _note quando houver mais páginas. Para resident Os itens são as listas de endereços residenciais, não os IPs. Para mix / mix_isp um pacote é distribuído em vários países: order_number e base_order_number incluir um sufixo específico para cada país (NS_…-dX_GBR, NS_…-dX_DEU) enquanto order_id é compartilhado — agrupar por order_id; a _note O resultado confirma isso. password é "••••" a menos que reveal: true. ⚠️ Dados confidenciais — o resultado inclui um aviso que o assistente repete para você.

export_proxies

🢢 read-only · account:read

Exporte os proxies como uma lista pronta para uso, um proxy por linha. Ocultados por padrão: ip:port. Com reveal: true as linhas são conectáveis login:password@host:port.

Parâmetro

Tipo

Descrição

type obrigatório

tipo de proxy, incl. subresident

Tipo de produto

ext

string

txt (padrão), csv, ou um modelo como %login%:%password%@%ip%:%port%. Sem reveal, txt torna-se %ip%:%port%; csv (cujo layout fixo ip;port;login;password (sempre contém a senha) e um modelo de nomenclatura %password% são recusados até que você confirme a revelação

proto

https | socks5

Apenas um tipo de porta (não para uso residencial)

protocol

http | socks5

Somente para uso residencial (resident, subresident): o esquema de cada linha. Com txt uma linha fica assim socks5://login:password@host:port; csv mantém suas colunas; um modelo obtém o valor em %protocol% (um modelo não pode conter /, portanto, use txt para scheme:// linhas). Sem isso, as linhas não têm estrutura. Não é o mesmo que proto; não há https. socks5 também suporta UDP e HTTP/3 (QUIC)

host

res.proxy-seller.com | us.res.proxy-seller.com | asia.res.proxy-seller.com

Apenas residencial: o gateway em cada linha — Europa (padrão), EUA ou Ásia. Apenas o ponto de entrada; a localização do IP de saída é obtida a partir das configurações da lista

country

string

Código Alpha-3 (não para uso residencial)

ends

booleano

Apenas proxies com validade prestes a expirar (não para uso residencial)

listId

string | inteiro

ID da lista residencial (resident e subresident); omitir a exportação de todas as listas

package_key

string

Chave do subpacote, com type: "subresident"

maxLine

inteiro

Número máximo de linhas, apenas para uso residencial

reveal

booleano

Retornar conectável login:password@host:port linhas em vez de ip:port. O assistente confirma com você primeiro — veja Senhas de proxy e o provedor de IA

Resultados: Com um plano residencial protocol as linhas seguem o esquema: socks5://host:port por padrão, socks5://login:password@host:port com reveal: true. Sem reveal as linhas são seguidas por uma nota informando que as senhas foram omitidas — o assistente transmite essa informação, de modo que uma lista sem senhas nunca é apresentada como as credenciais que você solicitou. Solicitar csv está solicitando as senhas: o assistente avisa que o arquivo incluirá suas credenciais de proxy na conversa e pede que você confirme antes de exportá-lo.

get_reference

🢢 read-only · account:read

Países disponíveis, períodos de aluguel e pacotes para um tipo de produto. Informações necessárias antes da definição de preços ou da realização de pedidos. Os países são códigos alfa-3 (USA), os pontos são códigos curtos (1m). Para dispositivos móveis, ele também exibe operadoras e opções de planos; para residências — tarifas de tráfego.

Parâmetro

Tipo

Descrição

type obrigatório

tipo de proxy

Tipo de produto

calc_order_cost

🢢 read-only · account:read

Preço e desconto para um novo pedido, sem que ele seja efetuado. Utiliza os mesmos parâmetros que make_order.

make_order

💳 spends money · billing:write

Faça um novo pedido por procuração. O valor será debitado do saldo. Se você fizer o pedido duas vezes, serão criados dois pedidos.

Parâmetro

Tipo

Descrição

type obrigatório

tipo de proxy

Tipo de produto (use make_resident_order (para tráfego residencial)

countryId obrigatório

string

De get_reference, por exemplo: USA

periodId obrigatório

string

De get_reference, por exemplo: 1m

quantity obrigatório

inteiro

Número de proxies (ipv6 (mínimo de 10)

paymentId obrigatório

string

balance ou paddle_subscription

customTargetName

string

Para que servem os proxies, como um nome abreviado de site ou serviço (Google, Instagram). Obrigatório para ipv4, ipv6, isp. Um destino que a conta nunca utilizou é considerado um novo destino: um gerente precisa aprová-lo manualmente e o pedido permanece pendente até então; por isso, o assistente prefere um dos destinos já existentes na conta (list_orders → targets)

coupon

string

Código promocional

generateAuth

booleano

Gere login/senha para os novos proxies

protocol

HTTPS | SOCKS5

Substituição de protocolo

mobileServiceType

shared | dedicated

Apenas para dispositivos móveis, obrigatório

operatorId

string

Somente para celular, obrigatório — operadora de get_reference

rotationId

string

Apenas para dispositivos móveis, obrigatório — rotação em minutos a partir de get_reference

mixId

string

Apenas MIX — código do pacote de get_reference

uptime

booleano

Apenas IPv4/ISP — Modo de alta disponibilidade, quando oferecido

Erro comum: o pedido foi pago, mas permanece pendente por mais de um minuto. Quando seu customTargetName é novo na conta, provisioning.targetNote é o que diz: o CRM criou uma nova meta de uso que um gerente aprova manualmente, e as procurações são emitidas depois disso — não há nada de errado com o pagamento ou com as ações. Verifique novamente mais tarde com verificar_status_do_pedido, ou reutilize um destino existente na próxima vez.

list_orders

🢢 read-only · account:read

Seus pedidos, dos mais recentes aos mais antigos — compras e renovações — com seus IDs, status, valor, datas, tipo de proxy e destino de uso, além dos destinos de uso específicos da conta. Use isso para escolher um customTargetName que a conta já possui antes de fazer o pedido, para encontrar o order_id valoriza um ipv6 / mix / mix_isp a renovação leva orderIds, e para o histórico de pedidos.

Parâmetro

Tipo

Descrição

order_id

string | inteiro

Um pedido (order_id retorna-o com suas extensões; o valor numérico de uma linha id retorna essa linha)

start_date / end_date

string

Limites de data de criação, yyyy-MM-dd ou dd.MM.yyyy

status

PAYED | NOT_PAYED | RETURN

Filtro de status da máquina

is_extend

booleano

true apenas extensões, false somente compras

auto_order

booleano

true colocados por meio da API ou renovados automaticamente, false inserido manualmente

page / limit

inteiro

Paginação: 50 linhas por página por padrão; a _note indica quando houver mais páginas. targets sempre abrange todas as ordens correspondentes

Resultados: {metadata: {total_orders, total_pages, current_page, current_limit}, items: [{id, order_id, order_number, base_order_number, status, status_type, summ, date_insert, date_payed, payment_name, is_extend, auto_order, auth_way, auth_ip, protocol, items: [{order_part_id, type, quantity, target, target_section, time, price, name, ...}], ...}], targets: string[], _note?}. summ é uma string de moeda ($12.50), as datas seguem a norma ISO 8601; o alvo de uso está em cada parte do pedido (items[].items[].target); criar ramificação em status_type, e não status.

verificar_status_do_pedido

🢢 read-only · account:read

Verifica se as procurações de um pedido feito foram emitidas, contando o número de procurações list_proxies vale para o pedido — para cada tipo, incluindo pacotes MIX. Embora um pedido MIX ainda não liste endereços IP, os logins por país em list_auth são as evidências alternativas (started). Pode ser chamado repetidamente com segurança; retorna um status e os próximos passos. O gabinete identifica um pacote MIX por meio de seu order_part_id, o que difere de orderId; ou seja, na mesma ordem.

Parâmetro

Tipo

Descrição

type obrigatório

tipo de proxy

Tipo de produto

orderId obrigatório

string | inteiro

orderId de make_order

expectedQuantity

inteiro

Quantidade pedida, para detectar entrega parcial

baseOrderNumbers

string[]

Apenas MIX — listBaseOrderNumbers do make_order resposta, usada como alternativa para o login

Resultados: status é provisioned, partial, started (MIX: logins já existem, IPs ainda não listados) ou pending. proxies[] são os registros emitidos com password mascarado — use list_proxies / export_proxies com reveal: true para credenciais.

calc_prolong_cost

🢢 read-only · account:read

Preço de renovação para proxies específicos, sem renovação. Mesmos parâmetros que make_prolong.

Resultados: items são os proxies que seriam renovados, password mascarado.

make_prolong

💳 spends money · billing:write

Renove os proxies por mais um período. A cobrança será feita na forma de pagamento selecionada. Se a solicitação for feita duas vezes, a cobrança será feita duas vezes.

Parâmetro

Tipo

Descrição

type obrigatório

ipv4 | ipv6 | mobile | isp | mix | mix_isp

Tipo de produto. Um pacote residencial não é renovado por período — compre tráfego com make_resident_order

periodId obrigatório

string

De get_reference

paymentId obrigatório

string

balance ou um método de list_payments

ips

string[]

ipv4 / isp / mobile: endereços de proxy como list_proxies mostra-os

ids

(string | inteiro)[]

ipv4 / isp / mobile: IDs de proxy

orderIds

(string | inteiro)[]

ipv6 / mix / mix_isp: o order_id valores de list_proxies. Esses produtos são vendidos e renovados como pedidos completos — todos os proxies ativos do pedido são renovados e cobrados

coupon

string

Código promocional

A escolha do seletor depende de type: ipv4, isp e mobile take ids ou ips; ipv6, mix e mix_isp take orderIds. Para um tipo de ordem completa, você ainda pode passar ids ou ips — a ferramenta do assistente os converte para suas ordens — mas a própria API aceita apenas orderIds aí.

Erro comum: uma segunda renovação de um pedido que ainda está sendo renovado é recusada antes do pagamento (código 57, “já em andamento”) — nada é cobrado; aguarde e verifique list_proxies em vez de tentar novamente às cegas. “A prorrogação não foi aplicada, o pagamento foi devolvido ao saldo” significa que a renovação foi revertida e o dinheiro está de volta ao saldo.

replace_proxy

🟡 changes account state · account:write

Solicite a substituição de proxies que não estejam funcionando. Cada proxy pode ser substituído uma vez por dia.

Parâmetro

Tipo

Descrição

ids obrigatório

(string | inteiro)[]

IDs de proxy

reason obrigatório

NOT_WORK | INCORRECT_LOCATION | CANT_CHANGE_NETWORK | LOW_SPEED | CUSTOM

Motivo

comment

string

Obrigatório quando reason é CUSTOM

set_proxy_comment

🟡 changes account state · account:write

Defina o mesmo comentário em um ou mais proxies. Substitui o comentário anterior; uma string vazia o apaga.

Parâmetro

Tipo

Descrição

ids obrigatório

(string | inteiro)[]

IDs de proxy

comment obrigatório

string

Texto do comentário

Próximos passos

On this page