Casos de uso
Atualizado:
Cada fluxo mostra um exemplo de solicitação e as ferramentas que o assistente aciona, em ordem. Você não precisa nomear as ferramentas — basta usar linguagem simples.
Verifique o que está prestes a expirar
💬 “Quais dos meus proxies IPv4 expiram nos próximos 7 dias? Mostre o IP, o país e a data de validade.”
Uma chamada: list_proxies com type: "ipv4", ends: true.
Comprar proxies
💬 “Compre 10 proxies IPv4 dos EUA por 1 mês para o Google, pague com o saldo.”
get_reference — códigos válidos de país e período.
calc_order_cost — preço; o assistente o exibe e pede confirmação.
get_balance — fundos suficientes?
make_order — após sua confirmação.
verificar_status_do_pedido — até que as procurações sejam emitidas.
export_proxies —
ip:portlinhas, além de uma nota informando que as senhas foram omitidas; com a sua confirmação,reveal: truepara conectávellogin:password@host:portlinhas.
Obtenha proxies residenciais para um local
💬 “Me dê 5 proxies residenciais em Berlim, com IP fixo, no formato login:senha@host:port.”
get_resident_geo_count —
country: "DE",city: "Berlin"— existem nós?add_resident_list —
ports: 5,rotation: -1,country: "DE",city: "Berlin"— a região que a API precisa (State of Berlin) é consultado automaticamente.export_proxies —
type: "resident",listId,ext: "%login%:%password%@%ip%:%port%"— o modelo solicita credenciais, então o assistente confirma com você e encaminhareveal: true.
Sem a etapa de confirmação, um modelo que nomeia %password% é recusado e o assistente pergunta a você primeiro; uma exportação simples (sem modelo) retorna como ip:port linhas com uma nota informando que as senhas foram omitidas — isso é o padrão, não uma falha.
Analisar o tráfego residencial
💬 “Quanto tráfego residencial eu usei em agosto e quanto isso custou? Qual lista consumiu mais?”
get_resident_consumption —
date_start: "2026-08-01",date_end: "2026-08-31".get_resident_package — o que resta.
Dê a um companheiro de equipe seu próprio tráfego
💬 “Crie um subusuário com 5 GB e uma lista dos EUA com 20 portas, com rotação a cada 5 minutos.”
get_resident_package — ainda tem tráfego suficiente?
create_resident_subpackage —
traffic_limit: 5368709120,is_link_date: true.add_resident_subuser_list —
country: "US",ports: 20,rotation: 300.export_proxies —
type: "subresident",package_key— umip:portlista; com a sua confirmação,reveal: truepelas credenciais que você fornecer.
Pause-os mais tarde:
💬 “Pause esse subusuário”
→ update_resident_subpackage com is_active: false.
Nunca deixe os proxies expirarem
💬 “Ative a renovação automática para todos os meus proxies de provedor de internet a partir do saldo e recarregue US$ 50 sempre que o saldo ficar abaixo de US$ 20.”
calc_autoprolong_cost — valor recorrente e data da próxima cobrança.
enable_autoprolong — após confirmação.
get_autotopup — uma carta é vinculada?
set_autotopup —
threshold: 20,amount: 50.
Ambos apresentam uma acusação recorrente — veja Pagamentos e segurança.
Corrigir um proxy defeituoso
💬 “O proxy 185.x.x.x não está funcionando, substitua-o.”
list_proxies — encontre-o.
replace_proxy —
reason: "NOT_WORK".
Gerenciar acesso
💬 “Adicione meu IP 1.1.1.1 à lista de permissões para o pedido 1234567”
Uma chamada: add_auth com ip, orderNumber.
💬 “Altere a senha desse login para …”
list_auth — obtenha a autorização.
change_auth — envie apenas as alterações.
💬 “Mova a lista de permissões da ordem 1234567 para 2.2.2.2”
→ list_auth → change_auth (ip).
💬 “Bloquear o acesso a partir de 1.1.1.1”
→ list_auth → delete_auth — uma autorização de IP não pode ser desativada sem um novo IP.
Criar uma integração
💬 “Como faço para renovar proxies por meio da API? Mostre um exemplo em Node.js.”
ps_docs_search — encontre a página correta.
ps_api_get_endpoint — leia as instruções.
ps_sdk_snippet —
lang: "node".
Trabalha apenas com docs:read — sua conta nunca é alterada.