Proxies e pedidos
Atualizado:
Permissões: account:read, account:write, faturamento:escrever
Neste grupo
Ferramenta | O que ele faz | |
|---|---|---|
🢢 | 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. | |
🢢 | Exporte os proxies como uma lista pronta para uso, com um proxy por linha. | |
🢢 | Países disponíveis, períodos de aluguel e pacotes para um tipo de produto. | |
🢢 | Preço e desconto para um novo pedido, sem que ele seja efetuado. | |
💳 | Faça um novo pedido de proxy. | |
🢢 | Seus pedidos, com os mais recentes em primeiro lugar, e os alvos de uso já existentes na conta. | |
🢢 | Verifica se as ordens de proxy de um pedido já foram emitidas. | |
🢢 | Preço de renovação para proxies específicos, sem renovação. | |
💳 | Renove as procurações por mais um período. | |
🟡 | Solicite a substituição de proxies que não estejam funcionando. | |
🟡 | 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 |
|---|---|---|
| tipo de proxy | Tipo de produto. |
| string | inteiro | Apenas um pedido |
| string | Código Alpha-3, por exemplo: |
| booleano | Apenas as procurações emitidas mais recentemente |
| booleano | Apenas proxies que expiram em breve |
| inteiro | Página para retornar (padrão |
| booleano | Voltar |
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 |
|---|---|---|
| tipo de proxy, incl. | Tipo de produto |
| string |
|
|
| Apenas um tipo de porta (não para uso residencial) |
|
| Somente para uso residencial ( |
|
| 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 |
| string | Código Alpha-3 (não para uso residencial) |
| booleano | Apenas proxies com validade prestes a expirar (não para uso residencial) |
| string | inteiro | ID da lista residencial ( |
| string | Chave do subpacote, com |
| inteiro | Número máximo de linhas, apenas para uso residencial |
| booleano | Retornar conectável |
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 |
|---|---|---|
| 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 |
|---|---|---|
| tipo de proxy | Tipo de produto (use make_resident_order (para tráfego residencial) |
| string | De get_reference, por exemplo: |
| string | De get_reference, por exemplo: |
| inteiro | Número de proxies ( |
| string |
|
| string | Para que servem os proxies, como um nome abreviado de site ou serviço (Google, Instagram). Obrigatório para |
| string | Código promocional |
| booleano | Gere login/senha para os novos proxies |
|
| Substituição de protocolo |
|
| Apenas para dispositivos móveis, obrigatório |
| string | Somente para celular, obrigatório — operadora de get_reference |
| string | Apenas para dispositivos móveis, obrigatório — rotação em minutos a partir de get_reference |
| string | Apenas MIX — código do pacote de get_reference |
| 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 |
|---|---|---|
| string | inteiro | Um pedido ( |
| string | Limites de data de criação, |
|
| Filtro de status da máquina |
| booleano |
|
| booleano |
|
| inteiro | Paginação: 50 linhas por página por padrão; a |
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 |
|---|---|---|
| tipo de proxy | Tipo de produto |
| string | inteiro |
|
| inteiro | Quantidade pedida, para detectar entrega parcial |
| string[] | Apenas MIX — |
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 |
|---|---|---|
|
| Tipo de produto. Um pacote residencial não é renovado por período — compre tráfego com make_resident_order |
| string | |
| string |
|
| string[] |
|
| (string | inteiro)[] |
|
| (string | inteiro)[] |
|
| 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 |
|---|---|---|
| (string | inteiro)[] | IDs de proxy |
|
| Motivo |
| string | Obrigatório quando |
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 |
|---|---|---|
| (string | inteiro)[] | IDs de proxy |
| string | Texto do comentário |