静态-IP 列表

支持多条件筛选；pageNum 默认从 1 开始（与 通用信息 中动态列表分页不同）。

鉴权

所有渠道商接口均需在请求头中携带 accessKeySecret。密钥在渠道商管理平台中获取，并可根据需要重置。详见 通用信息。

接口描述

项目	说明
方法	POST
地址	https://api2.ipmart.io/custom/static/getIpsByPageV2

输入参数

参数名称	必选	类型	描述
subUserId	是	String	子用户 ID（精确匹配，不支持模糊）
pageNum	否	Int	页码，默认 1
pageSize	否	Int	每页条数，默认 10
areaCode	否	String	区域编码或名称（模糊）
countryCode	否	String	国家编码或名称（模糊）
cityCode	否	String	城市编码或名称（模糊）
staticProxyIp	否	String	静态 IP（模糊）
orderNo	否	String	订单号（模糊）
status	否	Int	0 生效中；1 已过期；2 全部

重要输出参数

参数名称	必选	类型	描述
status	是	Int	返回码
errorMsg	否	String	错误信息
data	是	Object	分页对象（Spring Page），字段见下
content	是	Array	IP 列表（位于 data.content），元素字段见下
totalElements	是	Long	总条数
totalPages	是	Int	总页数
number	是	Int	当前页（从 0 开始）
size	是	Int	每页大小

content 列表元素

参数名称	必选	类型	描述
ip	是	String	静态 IP
port	是	String	端口
areaCode	是	String	区域编码
countryCode	是	String	国家编码
cityCode	是	String	城市编码
areaName	是	String	区域名称
countryName	是	String	国家名称
cityName	是	String	城市名称
userName	是	String	代理账户名
passwd	是	String	代理密码
width	是	Int	带宽（MB），固定返回 10
orderNo	是	String	关联订单号
startDate	是	String	开始时间
endDate	是	String	结束时间
days	是	Int	购买/续费天数
email	否	String	子用户邮箱
remark	否	String	备注

发送示例

{
  "subUserId": "661f908102ca4953bc555a18",
  "pageNum": 1,
  "pageSize": 10,
  "status": 0
}

返回示例

成功

{
  "status": 200,
  "errorMsg": null,
  "data": {
    "content": [
      {
        "ip": "154.196.142.192",
        "port": "10000",
        "areaCode": "NA",
        "countryCode": "US",
        "cityCode": "Random",
        "areaName": "北美",
        "countryName": "美国",
        "cityName": "随机",
        "userName": "proxyUser01",
        "passwd": "xxxxxx",
        "width": 10,
        "orderNo": "20260927180000000",
        "startDate": "2026-09-01 12:00:00",
        "endDate": "2026-10-01 12:00:00",
        "days": 30,
        "email": "user@example.com",
        "remark": ""
      }
    ],
    "totalElements": 1,
    "totalPages": 1,
    "number": 0,
    "size": 10
  }
}