Cas d'utilisation
Updated:
Chaque enchaînement présente un exemple de demande et les outils que l'assistant appelle, dans l'ordre. Vous n'avez pas besoin de nommer les outils — un langage simple suffit.
Vérifier ce qui arrive à expiration
💬 « Lesquels de mes proxys IPv4 expirent dans les 7 prochains jours ? Affiche l'adresse IP, le pays et la date d'expiration. »
Un exemple : list_proxies avec type: "ipv4", ends: true.
Acheter des proxys
💬 « Achetez 10 proxys IPv4 américains pour 1 mois pour Google, payez avec votre crédit. »
get_reference — codes de pays et de période valides.
calc_order_cost — prix ; l’assistant l’affiche et demande confirmation.
get_balance — As-tu suffisamment de fonds ?
make_order — après votre confirmation.
vérifier_l'état_de_la_commande — jusqu’à ce que les procurations soient délivrées.
export_proxies —
ip:portlignes, plus une note indiquant que les mots de passe ont été omis ; avec votre accord,reveal: truepour connectablelogin:password@host:portlignes.
Obtenir des proxys résidentiels pour un lieu donné
💬 « Donnez-moi 5 proxys résidentiels à Berlin, avec une adresse IP fixe, sous la forme identifiant:mot de passe@serveur:port. »
get_resident_geo_count —
country: "DE",city: "Berlin"— Y a-t-il des nœuds ?add_resident_list —
ports: 5,rotation: -1,country: "DE",city: "Berlin"— la région requise par l'API (State of Berlin) est recherchée automatiquement.export_proxies —
type: "resident",listId,ext: "%login%:%password%@%ip%:%port%"— le modèle demande des identifiants ; l’assistant vérifie donc auprès de vous et transmetreveal: true.
Sans l'étape de confirmation, un modèle qui nomme %password% est refusée et l'assistant vous demande d'abord ; une exportation simple (sans modèle) renvoie alors ip:port lignes accompagnées d'une note indiquant que les mots de passe ont été omis — il s'agit du comportement par défaut, et non d'une erreur.
Analyse du trafic résidentiel
💬 « Quelle a été ma consommation de données résidentielles en août et combien cela m’a-t-il coûté ? Quelle liste a consommé le plus ? »
get_resident_consumption —
date_start: "2026-08-01",date_end: "2026-08-31".get_resident_package — ce qui reste.
Donnez à un coéquipier son propre trafic
💬 « Créez un sous-utilisateur avec 5 Go et une liste américaine comprenant 20 ports, avec une rotation toutes les 5 minutes. »
get_resident_package — Il reste suffisamment de trafic ?
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— unip:portliste ; avec votre accord,reveal: truepour les identifiants que vous communiquez.
Mettez-les de côté pour plus tard :
💬 « Mettre ce sous-utilisateur en pause »
→ update_resident_subpackage avec is_active: false.
Ne laissez jamais les proxys expirer
💬 « Active le renouvellement automatique de tous mes proxys ISP à partir du solde, et recharge-le de 50 $ dès que le solde passe en dessous de 20 $. »
calc_autoprolong_cost — montant récurrent et date de la prochaine facturation.
enable_autoprolong — après confirmation.
get_autotopup — Une carte est-elle liée ?
set_autotopup —
threshold: 20,amount: 50.
Ces deux éléments alimentent une critique récurrente — voir Paiements et sécurité.
Corriger un proxy défectueux
💬 « Le proxy 185.x.x.x ne fonctionne pas, remplacez-le. »
list_proxies — Trouvez-le.
replace_proxy —
reason: "NOT_WORK".
Gérer les droits d'accès
💬 « Ajoutez mon adresse IP 1.1.1.1 à la liste blanche pour la commande n° 1234567 »
Un appel : add_auth avec ip, orderNumber.
💬 « Modifiez le mot de passe de ce compte pour… »
list_auth — obtenir l'autorisation.
change_auth — n'envoyez que les modifications apportées.
💬 « Déplacez la liste blanche de l'ordre 1234567 vers 2.2.2.2 »
→ list_auth → change_auth (ip).
💬 « Bloquer l'accès depuis l'adresse 1.1.1.1 »
→ list_auth → delete_auth — Une autorisation IP ne peut pas être désactivée sans une nouvelle adresse IP.
Mettre en place une intégration
💬 « Comment renouveler les proxys via l'API ? Donnez un exemple en Node.js. »
ps_docs_search — Trouvez la bonne page.
ps_api_get_endpoint — Lire les instructions.
ps_sdk_snippet —
lang: "node".
Fonctionne uniquement avec docs:read — votre compte n'est jamais modifié.