Proxy-seller

住宅代理

Updated:

以编程方式管理住宅代理包、列表和会话。

套餐是您的住宅套餐--它有流量限制和到期日期。在套餐内,您可以创建列表:按 GEO 和轮换规则过滤的 IP 命名包。您可以通过列表的登录名/密码连接到代理,一个套餐可以容纳多个列表,用于不同的用途。

列表

创建、配置和删除代理列表

阅读

GET/resident/lists
获取现有 IP 列表
软件包中的所有列表,包括证书、GEO、轮换和白名单。
GET/resident/geo
获取所有地点
创建列表时的有效国家/地区/城市/ISP 值参考。

写

POST/resident/list/add
创建列表
使用自定义名称、GEO 过滤器和验证方法创建新列表。
POST/resident/list/rename
重命名列表
更改列表的显示名称,而不影响证书或设置。
POST/resident/list/rotation
更改旋转设置
设置粘性、按请求或按时间轮换(1-3600 秒)。
DELETE/resident/list/delete
删除列表
从软件包中删除列表。活动连接会在 ~60 秒内丢失。

包装

GET/resident/package
包装信息
轮换、流量限制、过期、软件包密钥。
POST/resident/consumption
消费成本
按清单和日期范围进行支出报告。
POST/resident/traffic/details
交通使用情况
日期范围内每个列表使用的带宽。

更多控制

所有住宅终端通用

  1. 基本 URL

    https://proxy-seller.com/personal/api/v1/{YourApiKey}/resident/
  2. 认证

    URL 路径中的 API 密钥 - 切勿记录完整的请求 URL。

  3. 误差模型

    业务错误会返回 HTTP 200,并填充 errors[]。

配置好代理后

Cases (FAQ)common scenarios and troubleshootingOpenBalancecheck funds before extending trafficOpen

常见问题

包装- 您的订阅(流量限制 + 过期)。列表- 一个已命名的登录名/密码捆绑包,其中包含地理位置和白名单过滤器,并置于软件包中。会议- 特定出口 IP 与单个连接的短暂绑定,通过_s_…后缀。

在软件包层面。列表就是证书和过滤器;consumption-cost按登录(即每个列表)汇总,但实际借记会打入软件包池。

每个端口都有一个独立的出口 IP - 并行使用它们来处理并发请求。在特定时刻,一个端口 = 一个出口 IP。

主软件包中的列表会提供一个凭证/过滤器捆绑包,但其流量共享软件包的流量池,没有上限。子软件包会分割出一块固定的流量(流量限制),有自己的过期时间和开关,删除时会将未使用的流量归还给父软件包。在子软件包中创建的列表也是如此,只是根据子软件包的片段计费。

当您需要为某个人(客户、团队、活动)设定硬性流量上限时,可使用子软件包,而无需放弃您的 API 密钥。所有管理仍通过您自己的密钥进行。当您只需要在自己的配额内进行凭证或地理隔离时,请使用普通列表。

是的:https://proxy-seller.com/personal/api/v1/{YourApiKey}/resident/....子用户变体使用/residentsubuser/....

通过同一 IP 运行 HTTP 和 SOCKS5。

公共信息应用程序接口不包括住宅套餐的计划性更新。/extend-proxies(/prolong/calc/{type},/prolong/make/{type}) 只接受基于 IP 的类型ipv4,ipv6,mobile,isp,mix,mix_isp.resident不在该列表中,也没有/resident/prolong终点。

之前通过仪表板续订住宅套餐expired_at由get-package-information.API 规范中没有记录到期时的具体行为(活动连接、未使用的流量结转),如果对您的集成有影响,请向支持人员核实。

On this page