Récupérer le proxy actif

Pour tirer le meilleur parti de ce point de terminaison API, assurez-vous de bien comprendre les types de proxys mis en place au sein de votre réseau. Utilisez les options de filtrage pour obtenir des données précises et pertinentes sur les proxys.

Pour plus d'informations sur la mise en œuvre de cette API, consultez la documentation de l'API, qui fournit des exemples de requêtes, les formats de réponse ainsi que des paramètres supplémentaires que vous pouvez utiliser pour personnaliser la récupération des données.

Point d'extrémité

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

Paramètres de chemin

Nom	Valeur	Description
Autorisation	`<Your_API_Key>`	Votre clé API personnelle (comment obtenir)
Type de proxy (facultatif)	`ipv4` `ipv6` `mobile` `isp` `mix` `mix_isp`	Le type de proxy que vous souhaitez récupérer

Nom

Valeur

Description

Autorisation

<Your_API_Key>

Votre clé API personnelle (comment obtenir)

Type de proxy (facultatif)

ipv4

ipv6

mobile

isp

mix

mix_isp

Le type de proxy que vous souhaitez récupérer

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

Paramètres de la requête

Nom	Type	Description
dernière	Chaîne de caractères	Oui/Non - Réutiliser la procuration de la dernière commande
orderId	Chaîne de caractères	Renvoyer un proxy à partir d'un élément spécifique orderId ou numéro de commande de base
pays	Chaîne de caractères	Nom du pays Alpha3 (FRA ou USA ou ...)
fin	Chaîne de caractères	Y - Liste des mandataires de fin de mandat
page	Entier	Numéro de page, commençant à 1. Ne fonctionne que pour /proxy/list/{type}. Si seul le paramètre per_page est fourni, la valeur par défaut est 1.
par page	Entier	Nombre de proxys par page. Ne fonctionne que pour /proxy/list/{type}. Si seul le paramètre « page » est fourni, la valeur par défaut est 100.

Exemple

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

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

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

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

Pour obtenir une liste de serveurs proxy page par page :

https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/proxy/list/ipv4?page=1&per_page=100

Réponse

Tous les types de proxys

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

Un type de mandataire

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "0678564",
                "order_id": "123456",
                "order_number": "2000096_20240080",
                "basket_id": "12345566",
                "ip": "31.6.33.97",
                "ip_only": "31.6.33.97",
                "protocol": "HTTP",
                "port_socks": 12345,
                "port_http": 12345,
                "login": "ruht5734hg",
                "password": "gou5h437g",
                "auth_ip": "",
                "rotation": null,
                "link_reboot": "#",
                "country": "Belgium",
                "country_alpha3": "BEL",
                "status": "Active",
                "status_type": "ACTIVE",
                "can_prolong": true,
                "date_start": "23.06.2024",
                "date_end": "23.07.2024",
                "comment": "",
                "auto_renew": "N",
                "auto_renew_period": "",
                "uptime": false
            }
        ]
    },
    "errors": []
}

Type de proxy incorrect

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

Réponse avec pagination

{
  "status": "success",
  "data": {
    "items": [],
    "page": 1,
    "per_page": 100,
    "total": 342,
    "total_pages": 4
  },
  "errors": []
}