本指南介绍如何重命名住宅列表、更改其轮换或删除它。
每个请求都使用您账户后台的个人 API 密钥（如何获取 API 密钥）。在以下示例中，请将 YOUR_API_KEY 替换为您自己的密钥。如需用账户余额支付，请使用 paymentId = 1。
步骤 1 — 列出住宅列表
列出您的住宅列表，并复制要管理的列表的 id。
接口地址
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
响应
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}
步骤 2 — 重命名列表
通过 id 和新的 title 重命名列表。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/rename
请求体
名称 | 类型 | 说明 |
id | Number | 列表 id。 |
title | String | 列表的新名称。 |
响应
{
"status": "success",
"data": { "id": 561, "title": "New name" },
"errors": []
}
步骤 3 — 更改轮换
或通过 id 更改列表轮换。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/rotation
请求体
名称 | 类型 | 说明 |
id | Number | 列表 id。 |
rotation | Number | 轮换： |
响应
{
"status": "success",
"data": { "id": 561, "title": "New name" },
"errors": []
}
步骤 4 — 或删除列表
通过 id 删除列表。 此操作不可撤销。
接口地址
DELETE https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/delete
请求体
名称 | 类型 | 说明 |
id | Number | 列表 id。 |
响应
{
"status": "success",
"data": { "deleted": true },
"errors": []
}