获取活动代理
Updated:
为了充分利用此 API 端点，请确保您清楚了解网络中部署的代理类型。利用筛选选项来获取准确且有意义的代理数据。
有关此 API 实现的更多详细信息，请参阅 API 文档，其中提供了请求示例、响应格式以及可用于自定义数据检索的其他参数。
端点
GEThttps://proxy-seller.com/personal/api/v2/{YourApiKey}/proxy/list/{type}
路径参数
姓名 | 值 | 描述 |
|---|---|---|
授权 |
| 您的个人 API 密钥 (如何获取) |
代理类型（可选） |
| 您要检索的代理类型 |
请注意，如果未指定代理类型，系统将返回您配置文件中所有可用的代理类型。
请求参数
姓名 | 类型 | 描述 |
|---|---|---|
最新 | 字符串 | 是/否 - 沿用上一笔订单的代理 |
orderId | 字符串 | 从特定位置返回一个代理orderId或baseOrderNumber |
国家 | 字符串 | Alpha3国家名称（FRA 或 USA 或 ...）简体中文（大陆） |
结束 | 字符串 | Y - 结束代理列表 |
页面 | 整数 | 页码，从 1 开始。仅适用于 /proxy/list/{type}。如果仅提供了 per_page，则默认为 1 |
每页 | 整数 | 每页显示的代理数量。仅适用于 /proxy/list/{type}。如果只提供了 page 参数，则默认为 100 |
示例
要检索所有类型的代理：
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/proxy/list要检索特定类型的代理（例如 IPv4）：
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/proxy/list/ipv4要按页面获取代理服务器列表：
https://proxy-seller.com/personal/api/v2/fj4948ffhg58gh843gh/proxy/list/ipv4?page=1&per_page=100回复
各类代理
{
"status": "success",
"data": {
"ipv4": [],
"ipv6": [],
"mobile": [],
"isp": [],
"mix": [],
"mix_isp": [],
"resident": [] //proxy lists
},
"errors": []
}一种代理类型
{
"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": []
}代理类型不正确
{
"status": "error",
"data": null,
"errors": [
{
"message": "Could not find description of list{type} in CrmUserApiProxy",
"code": 22002,
"customData": null
}
]
}带分页的响应
{
"status": "success",
"data": {
"items": [],
"page": 1,
"per_page": 100,
"total": 342,
"total_pages": 4
},
"errors": []
}