本指南介绍如何创建带轮换的地理定向住宅代理列表。
每个请求都使用您账户后台的个人 API 密钥（如何获取 API 密钥）。在以下示例中，请将 YOUR_API_KEY 替换为您自己的密钥。如需用账户余额支付，请使用 paymentId = 1。
步骤 1 — 检查套餐
确认住宅套餐处于活跃状态且有剩余流量。复制 package_key。
接口地址
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
响应
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
步骤 2 — 获取可用位置
下载可用位置（国家 / 地区 / 城市 / ISP），以了解准确的 GEO 值。响应是包含完整 GEO 树的 JSON/ZIP。
接口地址
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/geo
响应
[
{
"code": "US",
"name": "United States",
"regions": [
{ "name": "Washington", "cities": [ { "name": "Garfield", "isps": [ "FIRST-STEP" ] } ] }
]
}
]
步骤 3 — 创建列表
使用标题、geo 对象（来自步骤 2）、export 设置和轮换值创建列表。
接口地址
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
请求体
名称 | 类型 | 说明 |
title | String | 列表名称。 |
whitelist (可选) | String | 用于授权的 IP。留空则使用 用户名:密码。 |
geo | object | 包含 GEO 数据库中 |
export | object | 对象： |
rotation | Number | 轮换： |
示例
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
响应
{
"status": "success",
"data": {
"id": 561,
"title": "US Washington Garfield FIRST-STEP",
"login": "3c8aa1d4",
"password": "AZT62Dx3",
"geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
"export": { "ports": 10000, "ext": "txt" }
},
"errors": []
}
步骤 4 — 检查新列表
列出您的住宅列表以确认已创建并获取连接信息。
接口地址
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": []
}