本指南介绍如何通过 API 续费（延长）您已拥有的代理，以保留相同的 IP 地址。请及时续费——代理过期后 IP 可能会丢失。
每个请求都使用您账户后台的个人 API 密钥（如何获取 API 密钥）。在以下示例中，请将 YOUR_API_KEY 替换为您自己的密钥。如需用账户余额支付，请使用 paymentId = 1。
⚠️ 最后一步会从您的余额扣款。 请务必先在计算步骤确认费用。
流程概览
找到要续费的代理并复制其 ID。
选择支付方式（或使用余额）。
计算续费费用。
完成续费。
步骤 1 — 找到要续费的代理
列出您的活跃代理，并复制每个要延长的代理的 id。只有 can_prolong: true 的代理才能续费。记下代理类型（ipv4、ipv6、mobile、isp、mix、mix_isp）——后续步骤会用到。
接口地址
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
路径参数
名称 | 值 | 说明 |
type (可选) |
| 要获取的代理类型。省略时返回所有类型。 |
可选查询参数
名称 | 类型 | 说明 |
latest | String | Y/N — 仅返回最近一笔订单的代理。 |
orderId | String | 返回指定 orderId 或 baseOrderNumber 的代理。 |
country | String | 三字母国家代码（如 FRA、USA）。 |
ends | String | Y — 仅即将到期的代理。 |
示例
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/ipv4
响应
{
"status": "success",
"data": {
"items": [
{
"id": "0678564",
"order_id": "123456",
"ip": "31.6.33.97",
"protocol": "HTTP",
"port_http": 12345,
"port_socks": 12345,
"login": "ruht5734hg",
"password": "gou5h437g",
"country": "Belgium",
"country_alpha3": "BEL",
"status_type": "ACTIVE",
"can_prolong": true,
"date_start": "23.06.2024",
"date_end": "23.07.2024",
"auto_renew": "N"
}
]
},
"errors": []
}
复制每个要续费的代理的 id。确认 can_prolong 为 true。
步骤 2 — 选择支付方式
列出可用的支付方式，并复制您想要的 id 作为 paymentId。如需用账户余额支付，可跳过此步骤，直接使用 paymentId = 1。
接口地址
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list
响应
{
"status": "success",
"data": {
"items": [
{ "id": "30", "name": "Visa / MasterCard" },
{ "id": "41", "name": "USDT (TRC-20)" },
{ "id": "29", "name": "PayPal" },
{ "id": "35", "name": "Binance" }
]
},
"errors": []
}
步骤 3 — 计算续费费用
付款前先计算费用。批量和租期折扣的应用方式与网站一致。此步骤不会扣款。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/{type}
请求体
名称 | 类型 | 说明 |
ids | Number / Array | 单个 ID 或 |
periodId | String | 续费周期的 ID。可从 |
paymentId | String | 支付方式 ID。 |
coupon (可选) | String | 优惠券代码（如有）。 |
示例
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/ipv4
响应 — shows the total, your balance, the discount and the proxies being renewed:
{
"status": "success",
"data": {
"warning": "",
"balance": 40.4,
"total": 35.1,
"quantity": 5,
"currency": "USD",
"discount": 0.22,
"items": [ ... proxies being renewed ... ],
"orders": 2
},
"errors": []
}
如果余额不足，您会收到 Insufficient funds 提示：
{
"status": "error",
"data": {
"warning": "Insufficient funds. Total $2. Not enough $33.10",
"balance": 2,
"total": 35.1
},
"errors": []
}
步骤 4 — 完成续费（从余额扣款）
当计算出的费用无误时，创建续费订单。此步骤会从您的余额扣款。使用与步骤 3 相同的参数。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/{type}
请求体
名称 | 类型 | 说明 |
ids | Number / Array | 单个 ID 或 |
periodId | String | 续费周期的 ID（来自 |
paymentId | String | 支付方式 ID。 |
coupon (可选) | String | 优惠券代码（如有）。 |
示例
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/ipv4
响应 — returns the new order ID and your updated balance:
{
"status": "success",
"data": {
"orderId": 3388536,
"total": 35.1,
"listBaseOrderNumbers": [ "1000000_57471911" ],
"balance": 40.4
},
"errors": []
}
代理保留相同 IP，并更新到期日期。
完整 API 文档
Extend proxies — 计算并完成续费
Retrieve active proxy — 列出您的代理
Balance — 余额与支付方式