Actions avec des mandataires

Gérez les adresses IP dans le cadre de vos commandes de proxy : répertoriez-les, faites-les tourner, prolongez-les ou ajoutez-y des annotations.

Paramètre commun. Chaque point de terminaison de cette page fonctionne selon un ordre spécifique. Passez le paramètre orderNumber — vous pouvez l'obtenir à partir de GET /proxy/list.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list

Renvoie les proxys actifs regroupés par type.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list/{type}

Renvoie les proxys actifs d'un type donné. Prend en charge les mêmes paramètres de requête que /proxy/list

Paramètres de chemin

Nom

Valeur

Obligatoire

Description

Type

ipv4, ipv6, mobile, isp, mix, mix_isp, ou resident

Oui

Spécifie le type de proxys à inclure dans la liste téléchargée.

Autorisation

<Your_API_Key>

Oui

Votre clé API personnelle (Comment obtenir)

Paramètres de requête

Nom	Type	Obligatoire	Description
dernière mise à jour	Chaîne de caractères	Non	`Y`renvoie les proxys de la dernière commande active lorsque `orderId` n'est pas fournie.
orderId	Chaîne de caractères	Non	Renvoyer un proxy à partir d'un orderId ou d'un OrderPart.number spécifique
pays	Chaîne de caractères	Non	Nom de pays en version Alpha3 (FRA ou DEU, etc.)
fin	Chaîne de caractères	Non	`Y` retourne uniquement `ENDED` des proxys qui ont encore `dateEnd` à l'avenir. Les proxys fermés sont par ailleurs exclus.

Exemple

Pour récupérer des proxys de tous types :

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list

Pour récupérer des proxys d'un type spécifique (par exemple, IPv4) :

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/list/ipv4

Réponse

Tous types de proxys

{
  "status": "success",
  "data": {
    "ipv4": [],
    "ipv6": [],
    "mobile": [],
    "isp": [],
    "mix": [],
    "mix_isp": [],
    "resident": []
  },
  "errors": []
}

Un type de proxy

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ]
    },
    "errors": []
}

Type de proxy incorrect

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list/{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

Veuillez noter que si aucun type de proxy n'est spécifié, tous les types disponibles seront renvoyés pour votre profil.

GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/download/{type}

Exporter les adresses IP

Ce point de terminaison API vous permet de télécharger la liste de vos proxys.

Paramètres de l'URL :

Nom	Valeur	Obligatoire	Description
Type	`ipv4`, `ipv6`, `mobile`, `isp`, `mix`, `mix_isp`, ou `resident`	Oui	Spécifie le type de proxys à inclure dans la liste téléchargée.
Autorisation	`<Your_API_Key>`	Oui	Votre clé API personnelle (Comment obtenir)

Paramètres facultatifs

Nom	Valeur	Description
ext	txt csv	Spécifie le format dans lequel la liste de proxys sera téléchargée.
	%login%:%password%@%ip%:%port%	Format personnalisé
proto	https socks5	Spécifie le format de port de proxy que vous préférez pour les proxys.
listId	Nombre entier	Identifiant de la liste de proxys (uniquement pour les résidents ; s'il n'est pas défini, l'adresse IP de toutes les feuilles sera renvoyée)
package_key	Chaîne de caractères	Liste de proxys package_key (uniquement pour les résidents secondaires)
pays	Chaîne de caractères	Nom du pays dans la version Alpha3 (FRA ou USA ou…)
fin	Chaîne de caractères	`Y` - Liste des proxies de fin

Exemple

Pour récupérer des proxys d'un type spécifique (par exemple, IPv4) :

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/download/ipv4?ext=txt&proto=https

Réponse

Réponse : type de proxy incorrect

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Could not find description of list{type} in CrmUserApiProxy",
            "code": 22002,
            "customData": null
        }
    ]
}

Modifier

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/replace

Remplacer les adresses IP

Faire tourner une adresse IP sans perdre l'emplacement dans l'ordre. Compte dans le quota mensuel de remplacement.

Paramètres de chemin

Nom	Valeur	Obligatoire	Description
Autorisation	`<Your_API_Key>`	Oui	Votre clé API personnelle (Comment obtenir)

Corps de la requête

Nom	Type	Description
ids	Nombre	Un seul identifiant ou un tableau d'identifiants entre « [ ] », séparés par des virgules
commentaire	Chaîne de caractères	Commentaire facultatif à joindre à la demande
type	Chaîne de caractères	Type de remplacement

Exemple

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/replace
{
    "ids": ["10"],
    "type": "CUSTOM",
    "comment": "Test replace IP"
}

Réponse

{
    "status": "success",
    "data": {
        "ok": {
            "ips": [
                "11.55.11.0"
            ],
            "msg": "Replacement request submitted"
        }
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 503,
            "message": "Error api key",
            "customData": null
        },
        {
            "code": 503,
            "message": "IP not allowed",
            "customData": null
        },
        {
            "code": 503,
            "message": "Request limit reached",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set coorect type: NOT_WORK / INCORRECT_LOCATION / CANT_CHANGE_NETWORK / LOW_SPEED / CUSTOM",
            "customData": null
        }
    ]
}

Types de remplacement : NOT_WORK, INCORRECT_LOCATION, CANT_CHANGE_NETWORK, LOW_SPEED, CUSTOM

POST https://proxy-seller.com/personal/api/v2/{apiKey}/prolong/calc/{type}

Prolonger les adresses IP

Prolonger la durée de validité pour certaines adresses IP. Facturation à la journée et par adresse IP.

Ce document fournit un guide détaillé sur la manière de configurer le renouvellement automatique de vos adresses IP de différents types. Veuillez noter que les adresses IP doivent être renouvelées à temps pour conserver les mêmes adresses.

Calculer l'extension

Ce point de référence vous aide à calculer le coût. Les remises sur volume et sur la durée de location sont similaires à celles proposées par notre service.

Paramètres de chemin

Nom

Valeur

Obligatoire

Description

Autorisation

<Your_API_Key>

Oui

Votre clé API personnelle (Comment obtenir)

Type

ipv4

ipv6

mobile

isp

mix

mix_isp

Oui

Le type de proxy que vous souhaitez étendre

Corps de la requête

Nom	Type	Description
ids	Nombre	Un seul identifiant ou un tableau d'identifiants entre « [ ] », séparés par des virgules (comment les obtenir)
bon de réduction	Chaîne de caractères	Le commentaire que vous souhaitez ajouter
periodId	Chaîne de caractères	Identifiant de la période que vous avez sélectionnée dans la requête /reference/list/{type}

Exemple (par ex. ipv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/calc/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

Réponse

{
    "status": "success",
    "data": {
        "warning": "",
        "balance": 498648.72,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login ",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_UUf2Z3RtGH",
                "basket_id": "69fa4b7a5a1f522c7a53d58b",
                "ip": "11.55.11.0",
                "ip_only": "11.55.11.0",
                "protocol": "HTTP",
                "port_socks": 49453,
                "port_http": 49353,
                "login": "login",
                "password": "password",
                "authIp": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Germany",
                "country_alpha3": "DEU",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "05.05.2026",
                "date_end": "11.06.2026",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": ""
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/prolong/make/{type}

Prolonger les adresses IP

Dans cette section, vous apprendrez comment créer une commande de renouvellement.

Créer une commande de renouvellement

Crée une commande d'extension.

Paramètres de chemin

Nom

Valeur

Obligatoire

Description

Autorisation

<Your_API_Key>

Oui

Votre clé API personnelle (Comment obtenir)

Type

ipv4

ipv6

mobile

isp

mix

mix_isp

Oui

Le type de proxy que vous souhaitez étendre

Corps de la requête

Nom	Type	Description
ids	Nombre	Un seul identifiant ou un tableau d'identifiants entre « [ ] », séparés par des virgules (comment les obtenir)
bon de réduction	Chaîne de caractères	Code promotionnel.
periodId	Chaîne de caractères	Identifiant de la période que vous avez sélectionnée dans la requête /reference/list/{type}
paymentId	Chaîne de caractères	Identifiants du système de paiement «69e799e7497b2c153b33faca« - équilibre, »69e799e8497b2c153b33faed« - carte que vous avez ajoutée à votre collection »

Exemple (par ex. ipv4)

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/prolong/make/ipv4
{
    "ids": ["10"],
    "periodId": "1m",
    "coupon": "",
    "paymentId": "balance"
}

Réponse

{
    "status": "success",
    "data": {
        "orderId": "69fa4b795a1f522c7a53d589",
        "total": 3.49,
        "listBaseOrderNumbers": [
            "TEST_1778011001948-uc_e_UUf2Z3RtGH"
        ],
        "balance": 1.00
    },
    "errors": []
}

{
    "status": "error",
    "data": {
        "warning": "Insufficient funds. Total $3.49. Not enough $2.49",
        "balance": 1.00,
        "total": 3.49,
        "quantity": 1,
        "currency": "USD",
        "discount": 3.00,
        "items": [
            {
                "id": "69fa4b7f256cae5b70a79478",
                "order_id": "69fa4b795a1f522c7a53d589",
                "order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "base_order_number": "TEST_1778011001948-uc_e_f7iNLfHqK8",
                "ip": "11.55.11.0",
                "port_http": null,
                "port_socks": null,
                "login": "x2alltop0qRU6",
                "password": "gwBwtL9LMM",
                "authIp": "",
                "country": "Germany",
                "date_start": "05.05.2026 19:56:42",
                "date_end": "10.08.2026 23:59:59",
                "comment": "",
                "status": "Active",
                "rotation": null,
                "link_reboot": "#",
                "can_prolong": true
            }
        ],
        "orders": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "Set existed [periodId] from reference",
            "customData": null
        }
    ]
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/comment/set

Ajouter des commentaires

Ajoutez une note libre (256 caractères maximum) pour faciliter l'identification d'un IP dans l'interface utilisateur ou dans les fichiers exportés.

Paramètres de chemin

Nom	Valeur	Obligatoire	Description
Autorisation	`<Your_API_Key>`	Oui	Votre clé API personnelle (Comment obtenir)

Corps de la requête

Nom	Type	Description
ids	Nombre	Un seul identifiant ou un tableau d'identifiants entre « [ ] », séparés par des virgules (comment les obtenir)
commentaire	Chaîne de caractères	Le commentaire que vous souhaitez ajouter

Exemple

https://proxy-seller.com/personal/api/v2/afoov21vcoodewq/proxy/comment/set
{
    "ids": ["10"],
    "comment": "My server"
}

Réponse

{
    "status": "success",
    "data": {
        "updated": 1
    },
    "errors": []
}

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "code": 0,
            "message": "IP not found",
            "customData": null
        }
    ]
}

Commun à tous les points de terminaison proxy

URL de base

https://proxy-seller.com/personal/api/v2/{YourApiKey}/

Authentification
Clé API dans le chemin d'accès de l'URL.
Modèle d'erreur
Les erreurs métier renvoient un code HTTP 200 avec errors[] rempli.

Une fois que vous avez géré vos adresses IP

Authorizationissue per-order credentialsOpen Order actionsbuy more proxies when you need additional IPsOpen Balancecheck funds before bulk prolongationOpen

Actions avec des mandataires

Paramètres de chemin

Paramètres de requête

Exemple

Réponse

Paramètres de l'URL :

Paramètres facultatifs

Exemple

Réponse

Modifier

Paramètres de chemin

Corps de la requête

Exemple

Réponse

Calculer l'extension

Paramètres de chemin

Corps de la requête

Exemple (par ex. ipv4)

Réponse

Créer une commande de renouvellement

Paramètres de chemin

Corps de la requête

Exemple (par ex. ipv4)

Réponse

Paramètres de chemin

Exemple

Réponse

Commun à tous les points de terminaison proxy

URL de base

Authentification

Modèle d'erreur

Une fois que vous avez géré vos adresses IP

On this page