住宅代理
Updated:
通过编程方式管理住宅代理套餐、列表和会话。
“套餐”即您的订阅服务——它设有流量上限和有效期。在套餐内，您可以创建“列表”：这些是按地理位置（GEO）和轮换规则过滤的、命名好的IP地址集合。您通过列表的登录名/密码连接到代理，一个套餐可包含多个适用于不同使用场景的列表。
列表
创建、配置和删除代理列表
阅读
撰写
项目包
更多控制选项
所有住宅端点的通用要求
基础网址
https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/身份验证
URL路径中的API密钥——切勿记录完整的请求URL。
错误模型
业务错误会返回 HTTP 200 状态码，且 errors[] 字段已填充。
配置好代理后
Cases (FAQ)common scenarios and troubleshootingOpenBalancecheck funds before extending trafficOpen常见问题解答
项目包 — 您的订阅（流量限制 + 有效期）。列表 — 一个包含登录名/密码组合、带有地理位置和白名单过滤功能的包，该包位于某个软件包内。会话 — 将特定的出口 IP 与单个连接进行短暂绑定，通过以下方式动态建立：_s_… 登录名后缀。
在包级别。列表仅包含凭据和过滤器；consumption-cost 按登录账号汇总（即按列表），但实际扣费将计入套餐池。
每个端口都会分配一个独立的出口IP地址——请并行使用这些IP地址以处理并发请求。在特定时刻，一个端口对应一个出口IP地址。
主包内的列表会提供一个凭据/过滤器捆绑包——但其流量与主包共享流量池且无上限。子包则会划出固定流量份额（traffic_limit），并拥有独立的有效期和启用/禁用开关，删除时未使用的流量将返还给父包。 您在其中创建的列表也遵循相同原理——它们仅按子包的流量配额进行计费。
当需要为某对象（客户端、团队、营销活动）设置严格的流量上限时，请使用子包——且无需交出您的 API 密钥。所有管理操作仍通过您自己的密钥进行。若仅需在您自己的配额范围内进行凭证或地理隔离，请使用普通列表。
是：https://proxy-seller.com/personal/api/v2/{YourApiKey}/resident/...。子用户变体使用/residentsubuser/....
同一IP地址上同时运行HTTP和SOCKS5。
公共API未涵盖住宅套餐的程序化续订功能。/extend-proxies (/prolong/calc/{type},/prolong/make/{type}) 仅接受基于 IP 的类型 —ipv4,ipv6,mobile,isp,mix,mix_isp.resident 不在该列表中，且没有/resident/prolong endpoint.
请在……之前通过控制面板续订住宅套餐expired_at 报告人：get-package-information。API 规范中未明确说明到期时的具体行为（如活跃连接、未使用流量的结转等）——若这对您的集成至关重要，请向技术支持部门核实。