Mandataires et commandes
Updated:
Autorisations : account:read, account:write, facturation:rédaction
Dans ce groupe
Outil | Fonctionnalités | |
|---|---|---|
🟢 | Vos proxys actifs d'un même type : adresse IP, ports HTTP/SOCKS, identifiants, pays, date d'expiration, état de renouvellement automatique et commentaire. | |
🟢 | Exportez les proxys sous forme de liste prête à l'emploi, à raison d'un proxy par ligne. | |
🟢 | Pays disponibles, durées de location et formules proposées pour un type de produit. | |
🟢 | Prix et remise pour une nouvelle commande, sans passer commande. | |
💳 | Passer une nouvelle commande par procuration. | |
🟢 | Vos commandes, classées par ordre chronologique (les plus récentes en premier), et les cibles d'utilisation déjà présentes sur le compte. | |
🟢 | Vérifie si les procurations d'un ordre passé ont été émises. | |
🟢 | Prix de renouvellement pour certains proxys, sans renouvellement. | |
💳 | Renouveler les mandats pour une nouvelle période. | |
🟡 | Demander le remplacement des proxys qui ne fonctionnent pas. | |
🟡 | Ajoutez le même commentaire sur un ou plusieurs proxys. |
list_proxies
🟢 read-only · account:read
Vos proxys actifs d'un même type : adresse IP, ports HTTP/SOCKS, identifiants, pays, date d'expiration, état de renouvellement automatique et commentaire. password est renvoyé masqué, sauf si vous en faites la demande. Les proxys avec status: "Ended" sont fin prochaine, non expiré — date_end est la date d'expiration effective.
Paramètre | Type | Description |
|---|---|---|
| type de proxy | Type de produit. |
| chaîne | entier | Une seule commande |
| chaîne | Code Alpha-3, par exemple : |
| booléen | Uniquement les procurations les plus récentes |
| booléen | Uniquement les mandats arrivant bientôt à échéance |
| entier | Page vers laquelle revenir (par défaut) |
| booléen | Retour |
Résultats : {items: [...]} — un objet par proxy avec 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. La réponse est paginée (50 éléments par page par défaut) et contient page, per_page, total, total_pages, ainsi qu'un _note lorsqu'il existe d'autres pages. Par exemple : resident Les éléments concernés sont les listes d'adresses résidentielles, et non les adresses IP. Pour mix / mix_isp un même pack est commercialisé dans plusieurs pays : order_number et base_order_number être accompagnés d'un suffixe spécifique à chaque pays (NS_…-dX_GBR, NS_…-dX_DEU) tandis que order_id est partagé — regrouper par order_id; a _note C'est ce qu'indique le résultat. password est "••••" à moins que reveal: true. ⚠️ Données sensibles — le résultat comprend un avertissement que l'assistant vous répète.
export_proxies
🟢 read-only · account:read
Exportez les proxys sous forme de liste prête à l'emploi, à raison d'un proxy par ligne. Masqués par défaut : ip:port. Avec reveal: true les lignes sont reliaisables login:password@host:port.
Paramètre | Type | Description |
|---|---|---|
| type de proxy, y compris | Type de produit |
| chaîne |
|
|
| Un seul type de port (pas pour usage résidentiel) |
|
| Réservé aux particuliers ( |
|
| Réservé aux particuliers : la passerelle indiquée dans chaque ligne — Europe (par défaut), États-Unis ou Asie. Uniquement le point d'entrée ; l'emplacement de l'adresse IP de sortie provient des paramètres de la liste |
| chaîne | Code Alpha-3 (non destiné à un usage résidentiel) |
| booléen | Uniquement les proxys dont la durée d'expiration est proche (pas pour un usage résidentiel) |
| chaîne | entier | Identifiant de la liste des résidences ( |
| chaîne | Clé du sous-paquet, avec |
| entier | Nombre maximal de lignes, pour les particuliers uniquement |
| booléen | Retour connectable |
Résultats : Avec un hébergement résidentiel protocol Les lignes suivent le schéma suivant : socks5://host:port Par défaut, socks5://login:password@host:port avec reveal: true. Sans reveal Ces lignes sont suivies d’une note indiquant que les mots de passe ont été omis — l’assistant le signale, de sorte qu’une liste sans mot de passe n’est jamais présentée comme les identifiants que vous avez demandés. Demander csv L'assistant vous demande les mots de passe : il vous avertit que le fichier inclura vos identifiants de proxy dans la conversation et vous demande de confirmer avant de l'exporter.
get_reference
🟢 read-only · account:read
Pays disponibles, durées de location et formules proposées pour un type de produit. Informations requises avant la tarification ou la commande. Les pays sont indiqués par leur code alpha-3 (USA), les points sont des codes courts (1m). Pour les mobiles, il affiche également les opérateurs et les options de rotation ; pour les particuliers, les tarifs de trafic.
Paramètre | Type | Description |
|---|---|---|
| type de proxy | Type de produit |
calc_order_cost
🟢 read-only · account:read
Prix et remise pour une nouvelle commande, sans passer celle-ci. Reprend les mêmes paramètres que make_order.
make_order
💳 spends money · billing:write
Passer une nouvelle commande par procuration. Le montant est débité du solde. Si vous effectuez cette opération deux fois, deux commandes seront créées.
Paramètre | Type | Description |
|---|---|---|
| type de proxy | Type de produit (utiliser make_resident_order (pour le trafic résidentiel) |
| chaîne | Source : get_reference, par exemple : |
| chaîne | Source : get_reference, par exemple : |
| entier | Nombre de proxys ( |
| chaîne |
|
| chaîne | À quoi servent les proxys, en tant que nom court de site ou de service (Google, Instagram). Obligatoire pour |
| chaîne | Code promotionnel |
| booléen | Générer un identifiant et un mot de passe pour les nouveaux proxys |
|
| Remplacement du protocole |
|
| Uniquement sur mobile, obligatoire |
| chaîne | Mobile uniquement, obligatoire — opérateur à partir de get_reference |
| chaîne | Mobile uniquement, obligatoire — rotation en minutes à partir de get_reference |
| chaîne | MIX uniquement — code du package provenant de get_reference |
| booléen | IPv4/FAI uniquement — Mode haute disponibilité lorsque disponible |
Erreur courante : la commande est payée mais reste en attente pendant plus d'une minute. Lorsque sa customTargetName est nouveau sur le compte, provisioning.targetNote C'est ce qu'il dit : le CRM a créé une nouvelle cible d'utilisation qu'un responsable approuve manuellement, et les procurations sont émises par la suite — il n'y a aucun problème avec le paiement ou les actions. Vérifiez à nouveau plus tard avec vérifier_l'état_de_la_commande, ou réutilisez une cible existante la prochaine fois.
list_orders
🟢 read-only · account:read
Vos commandes, les plus récentes en premier — achats et prolongations — avec leurs identifiants, leur statut, leur montant, leurs dates, le type de proxy et la cible d'utilisation, ainsi que les cibles d'utilisation spécifiques du compte. Utilisez ces informations pour choisir un customTargetName dont le compte dispose déjà avant de passer commande, afin de trouver le order_id accorde de l'importance à ipv6 / mix / mix_isp le renouvellement prend la forme de orderIds, et pour l'historique des commandes.
Paramètre | Type | Description |
|---|---|---|
| chaîne | entier | Une commande ( |
| chaîne | Période de création, |
|
| Filtre d'état des machines |
| booléen |
|
| booléen |
|
| entier | Pagination, 50 lignes par page par défaut ; a |
Résultats : {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 est une chaîne de caractères représentant une devise ($12.50), les dates sont au format ISO 8601 ; la cible d'utilisation se trouve sur chaque élément de commande (items[].items[].target); créer une branche sur status_type, et non status.
vérifier_l'état_de_la_commande
🟢 read-only · account:read
Vérifie si les procurations d'une commande passée ont bien été émises, en comptant le nombre de procurations list_proxies s'applique à la commande — pour chaque type, y compris les packs MIX. Bien qu'une commande MIX ne mentionne pas encore d'adresses IP, les connexions par pays dans list_auth constituent les preuves de secours (started). Peut être appelé à plusieurs reprises en toute sécurité ; renvoie un statut et les étapes suivantes. L'armoire étiquette un paquet MIX en fonction de son order_part_id, ce qui diffère de orderId; c'est-à-dire dans le même ordre.
Paramètre | Type | Description |
|---|---|---|
| type de proxy | Type de produit |
| chaîne | entier |
|
| entier | Quantité commandée, pour détecter une livraison partielle |
| string[] | MIX uniquement — |
Résultats : status est provisioned, partial, started (MIX : les identifiants existent, les adresses IP ne sont pas encore répertoriées) ou pending. proxies[] sont les enregistrements émis avec password masqué — utiliser list_proxies / export_proxies avec reveal: true pour les identifiants.
calc_prolong_cost
🟢 read-only · account:read
Prix de renouvellement pour des proxys spécifiques, sans renouvellement. Mêmes paramètres que make_prolong.
Résultats : items sont les proxys qui seraient renouvelés, password masqué.
make_prolong
💳 spends money · billing:write
Renouveler les mandats pour une nouvelle période. Le montant est débité de la source de paiement sélectionnée. Si vous effectuez deux fois cette opération, le montant sera débité deux fois.
Paramètre | Type | Description |
|---|---|---|
|
| Type de produit. Un forfait résidentiel n'est pas renouvelé périodiquement — achetez du trafic avec make_resident_order |
| chaîne | Source : get_reference |
| chaîne |
|
| string[] |
|
| (chaîne | entier)[] |
|
| (chaîne | entier)[] |
|
| chaîne | Code promotionnel |
Le sélecteur à appliquer dépend de type: ipv4, isp et mobile prendre ids ou ips; ipv6, mix et mix_isp prendre orderIds. Pour un type « whole-order », vous pouvez tout de même passer ids ou ips — l’outil de l’assistant les convertit selon les consignes — mais l’API elle-même n’accepte que orderIds là.
Erreur courante : un deuxième renouvellement d’une commande en cours de renouvellement est refusé avant le paiement (code 57, « déjà en cours ») — rien n’est facturé ; attendez et vérifiez list_proxies plutôt que de réessayer à l'aveuglette. « Le renouvellement n'a pas été appliqué, le paiement a été recrédité sur le solde » signifie que le renouvellement a été annulé et que le montant a été recrédité sur le solde.
replace_proxy
🟡 changes account state · account:write
Demander le remplacement des proxys défaillants. Chaque proxy peut être remplacé une fois par jour.
Paramètre | Type | Description |
|---|---|---|
| (chaîne | entier)[] | Identifiants de proxy |
|
| Justification |
| chaîne | Requis lorsque |
set_proxy_comment
🟡 changes account state · account:write
Définissez le même commentaire sur un ou plusieurs proxys. Remplace le commentaire précédent ; une chaîne vide l'efface.
Paramètre | Type | Description |
|---|---|---|
| (chaîne | entier)[] | Identifiants de proxy |
| chaîne | Texte du commentaire |