住宅代理
Updated:
通过编程方式管理住宅代理套餐、列表和会话。
一个套餐即您的住宅版订阅——它设有流量限制和有效期。在套餐内，您可以创建列表：这些是按地理位置和轮换规则过滤后的、带有名称的 IP 地址集合。您可通过列表的登录名/密码连接到代理，一个套餐可包含多个适用于不同使用场景的列表。
列表
创建、配置和删除代理列表
阅读
GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/proxy/list
获取现有IP列表
您包中所有包含凭据、GEO、轮换和白名单的列表。
GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/geo
查看所有地点
创建列表时，有效国家/地区/城市/ISP值的参考。
写
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/add
创建列表
创建一个具有自定义名称、地理位置过滤器和身份验证方法的新列表。
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/rename
重命名列表
更改列表的显示名称，同时不影响凭据或设置。
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/rotation
更改旋转设置
设置固定、按请求或基于时间的轮询（1–3600 秒）。
DELETEhttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/list/delete
删除列表
从包中移除一个列表。活动连接将在约60秒内断开。
包装
GEThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/package
包装信息
轮询、流量限制、过期时间、包密钥。
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/consumption
消费成本
按列表和日期范围查看支出报告。
POSThttps://proxy-seller.com/personal/api/v2/{apiKey}/resident/traffic/details
流量使用情况
特定日期范围内各列表的带宽使用情况。
更多控制选项
所有住宅端点的共同点
基础网址
https://proxy-seller.com/personal/api/v1/{YourApiKey}/resident/身份验证
URL路径中的API密钥——切勿记录完整的请求URL。
误差模型
业务错误会返回 HTTP 200 状态码，同时 errors[] 字段会被填充。