本指南介绍如何将有问题的 IP 更换为新 IP。每个代理每天可请求一次 IP 更换。处理可能需要一些时间。
每个请求都使用您账户后台的个人 API 密钥（如何获取 API 密钥）。在以下示例中，请将 YOUR_API_KEY 替换为您自己的密钥。如需用账户余额支付，请使用 paymentId = 1。
步骤 1 — 找到要更换的代理
列出您的活跃代理，并复制每个要更换的代理的 id。记下代理类型。
接口地址
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
响应
{
"status": "success",
"data": {
"items": [
{ "id": "0678564", "ip": "31.6.33.97", "country_alpha3": "BEL", "status_type": "ACTIVE", "can_prolong": true, "date_end": "23.07.2024" }
]
},
"errors": []
}
步骤 2 — 请求更换
提交更换请求，附上代理 ids、type（更换原因）和可选备注。响应会返回新的 IP。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
请求体
名称 | 类型 | 说明 |
ids | Number / Array | 单个 ID 或 |
type | String | 更换原因——见下方允许的值。 |
comment (可选) | String | 随请求附带的可选备注。 |
允许的 type 值：NOT_WORK、INCORRECT_LOCATION、CANT_CHANGE_NETWORK、LOW_SPEED、CUSTOM。
示例
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/replace
响应
{
"status": "success",
"data": {
"ok": {
"ips": [ "31.6.33.97" ],
"msg": "Replacement request submitted"
}
},
"errors": []
}
完整 API 文档
Retrieve active proxy — 列出您的代理