Proxy-seller

Mandataires et commandes

Updated:

Autorisations : account:read, account:write, facturation:rédaction

Dans ce groupe

Outil

Fonctionnalités

list_proxies

🟢 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.

export_proxies

🟢 read

Exportez les proxys sous forme de liste prête à l'emploi, à raison d'un proxy par ligne.

get_reference

🟢 read

Pays disponibles, durées de location et formules proposées pour un type de produit.

calc_order_cost

🟢 read

Prix et remise pour une nouvelle commande, sans passer commande.

make_order

💳 pays

Passer une nouvelle commande par procuration.

list_orders

🟢 read

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érifier_l'état_de_la_commande

🟢 read

Vérifie si les procurations d'un ordre passé ont été émises.

calc_prolong_cost

🟢 read

Prix de renouvellement pour certains proxys, sans renouvellement.

make_prolong

💳 pays

Renouveler les mandats pour une nouvelle période.

replace_proxy

🟡 write

Demander le remplacement des proxys qui ne fonctionnent pas.

set_proxy_comment

🟡 write

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 obligatoire

type de proxy

Type de produit. mix concerne uniquement le paquet IPv4 MIX et mix_isp le pack ISP MIX — deux listes distinctes, donc « tous mes proxys MIX » désigne les deux. subresident n'est pas pris en charge ici : utilisez list_resident_subuser_lists

orderId

chaîne | entier

Une seule commande

country

chaîne

Code Alpha-3, par exemple : USA

latest

booléen

Uniquement les procurations les plus récentes

ends

booléen

Uniquement les mandats arrivant bientôt à échéance

page, per_page

entier

Page vers laquelle revenir (par défaut) 1) et la taille de la page (par défaut 50)

reveal

booléen

Retour password en clair plutôt que ••••. L'assistant vous demande d'abord votre accord — voir Mots de passe proxy et fournisseur d'IA

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 obligatoire

type de proxy, y compris subresident

Type de produit

ext

chaîne

txt (par défaut), csv, ou un modèle tel que %login%:%password%@%ip%:%port%. Sans reveal, txt devient %ip%:%port%; csv (dont la mise en page fixe ip;port;login;password (contient toujours le mot de passe) et un modèle de nommage %password% sont refusées tant que vous n'avez pas confirmé la divulgation

proto

https | socks5

Un seul type de port (pas pour usage résidentiel)

protocol

http | socks5

Réservé aux particuliers (resident, subresident) : la structure de chaque ligne. Avec txt une ligne devient socks5://login:password@host:port; csv conserve ses colonnes ; un modèle récupère la valeur dans %protocol% (un modèle ne peut pas contenir /, donc utilisez txt pour scheme:// lignes). Sans cela, les lignes n'ont pas de structure. Ce n'est pas la même chose que proto; il n'y a pas https. socks5 prend également en charge les protocoles UDP et HTTP/3 (QUIC)

host

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

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

country

chaîne

Code Alpha-3 (non destiné à un usage résidentiel)

ends

booléen

Uniquement les proxys dont la durée d'expiration est proche (pas pour un usage résidentiel)

listId

chaîne | entier

Identifiant de la liste des résidences (resident et subresident); ne pas exporter toutes les listes

package_key

chaîne

Clé du sous-paquet, avec type: "subresident"

maxLine

entier

Nombre maximal de lignes, pour les particuliers uniquement

reveal

booléen

Retour connectable login:password@host:port lignes au lieu de ip:port. L'assistant vous demande d'abord votre accord — voir Mots de passe proxy et fournisseur d'IA

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 obligatoire

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 obligatoire

type de proxy

Type de produit (utiliser make_resident_order (pour le trafic résidentiel)

countryId obligatoire

chaîne

Source : get_reference, par exemple : USA

periodId obligatoire

chaîne

Source : get_reference, par exemple : 1m

quantity obligatoire

entier

Nombre de proxys (ipv6 (minimum : 10)

paymentId obligatoire

chaîne

balance ou paddle_subscription

customTargetName

chaîne

À quoi servent les proxys, en tant que nom court de site ou de service (Google, Instagram). Obligatoire pour ipv4, ipv6, isp. Une destination que le compte n’a jamais utilisée est considérée comme une nouvelle destination : un responsable doit l’approuver manuellement et la commande reste en attente jusqu’à ce moment-là ; l’assistant préfère donc choisir l’une des destinations existantes du compte (list_orders → targets)

coupon

chaîne

Code promotionnel

generateAuth

booléen

Générer un identifiant et un mot de passe pour les nouveaux proxys

protocol

HTTPS | SOCKS5

Remplacement du protocole

mobileServiceType

shared | dedicated

Uniquement sur mobile, obligatoire

operatorId

chaîne

Mobile uniquement, obligatoire — opérateur à partir de get_reference

rotationId

chaîne

Mobile uniquement, obligatoire — rotation en minutes à partir de get_reference

mixId

chaîne

MIX uniquement — code du package provenant de get_reference

uptime

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

order_id

chaîne | entier

Une commande (order_id le renvoie avec ses prolongements ; la valeur numérique d'une ligne id renvoie cette ligne)

start_date / end_date

chaîne

Période de création, yyyy-MM-dd ou dd.MM.yyyy

status

PAYED | NOT_PAYED | RETURN

Filtre d'état des machines

is_extend

booléen

true prolongations uniquement, false achats uniquement

auto_order

booléen

true placés via l'API ou renouvelés automatiquement, false saisi manuellement

page / limit

entier

Pagination, 50 lignes par page par défaut ; a _note indique qu'il existe davantage de pages. targets couvre toujours toutes les commandes correspondantes

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 obligatoire

type de proxy

Type de produit

orderId obligatoire

chaîne | entier

orderId de make_order

expectedQuantity

entier

Quantité commandée, pour détecter une livraison partielle

baseOrderNumbers

string[]

MIX uniquement — listBaseOrderNumbers Extrait de make_order réponse, utilisée pour la solution de secours lors de la connexion

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 obligatoire

ipv4 | ipv6 | mobile | isp | mix | mix_isp

Type de produit. Un forfait résidentiel n'est pas renouvelé périodiquement — achetez du trafic avec make_resident_order

periodId obligatoire

chaîne

Source : get_reference

paymentId obligatoire

chaîne

balance ou une méthode issue de list_payments

ips

string[]

ipv4 / isp / mobile: adresses proxy telles que list_proxies les affiche

ids

(chaîne | entier)[]

ipv4 / isp / mobile: identifiants de proxy

orderIds

(chaîne | entier)[]

ipv6 / mix / mix_isp: le order_id valeurs provenant de list_proxies. Ces produits sont vendus et renouvelés sous forme de commandes complètes : chaque proxy actif de la commande est renouvelé et facturé

coupon

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

ids obligatoire

(chaîne | entier)[]

Identifiants de proxy

reason obligatoire

NOT_WORK | INCORRECT_LOCATION | CANT_CHANGE_NETWORK | LOW_SPEED | CUSTOM

Justification

comment

chaîne

Requis lorsque reason est CUSTOM

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

ids obligatoire

(chaîne | entier)[]

Identifiants de proxy

comment obligatoire

chaîne

Texte du commentaire

Prochaines étapes

On this page