Skip to main content
cURL
分页读取当前认证账户的住宅代理资产。此接口查询已有资产,不负责购买、续费或生成代理。

查询已有资产

  1. 从登录接口取得 Token,填写为 Bearer 凭据。
  2. 按下方参数设置分页,以及所需的状态、产品类型、地区、关键词或排序筛选。
  3. 发送后检查 HTTP 状态与业务结果,核对当前页和总数,再使用相同筛选读取下一页。
Vid 与 IspType 使用文档列出的枚举。需要 IspType=0 时保留该值;零是有效选项,不是空字段。排序使用文档中的字段,以及 asc 或 desc。不填可选筛选与明确传入筛选值不同。 表单分页范围来自当前公开界面。后台管理已购 IP 见静态住宅快速开始,错误处理见 API 响应处理说明。

在线调试

来源:官方住宅资产接口参考。

授权

Authorization
string
header
必填

使用登录响应中的 token,发送 Authorization: Bearer 请求头。Token 有效期和刷新方式未在来源中说明。

查询参数

PageNo
integer
必填

从 1 开始的页码。

示例:

1

PageSize
integer
必填

每页返回的记录数。

示例:

10

IspType
enum<integer>

-1 查询全部;0 为独享;1 为共享。

可用选项:
-1,
0,
1
示例:

-1

Vid
enum<string>

代理资产状态筛选。

可用选项:
all,
new,
valid,
exp,
expiringsoon
示例:

"all"

IspLocation
string

可选的 ISP 地区筛选。

KeyWord
string

按 IP 或相关标识搜索。

SortField
enum<string>

可按创建时间或过期时间排序。

可用选项:
sysCreateTime,
expireTime
SortOrder
enum<string>

可选。不传时沿用当前调用方的默认升序行为。

可用选项:
asc,
desc

响应

ISP 代理分页结果

code
integer
message
string
body
object