分页查询已购买 IP 列表

1. 接口描述

该接口用于分页检索当前账户下所有已分配的静态 IP 资产。与“根据订单查询”不同，此接口支持跨订单展示，并包含分页功能。

• 请求方式：POST
• 接口地址：https://api.cueip.com/api/static-proxy/ips
• 内容类型：application/json

2. 请求头规范 (Header)

字段名	类型	是否必填	描述
X-APP-ID	String	是	应用唯一标识
X-NONCE	String	是	随机字符串
X-TIMESTAMP	Long	是	Unix 时间戳 (秒)
X-SIGN	String	是	动态签名

签名生成逻辑请参考：签名生成指南

3. 请求参数说明 (Body)

字段名	类型	是否必填	描述	示例
pageNo	Integer	否	当前页码（从 1 开始）	1
pageSize	Integer	否	每页返回记录数	10

4. 请求示例

POST api/static-proxy/ips
Host: api.cueip.com
Content-Type: application/json

{
    "pageNo": 1,
    "pageSize": 10
}

5. 响应参数说明

成功响应 (200 OK)

字段名	类型	描述
code	Integer	状态码，0 表示成功
data	Object	结果集对象
├ total	Integer	总记录数
├ list	Array	IP 资产列表
├─ proxyId	Long	系统生成的 IP 唯一编号
├─ orderNo	String	所属订单编号
├─ proxyIp	String	代理服务器地址
├─ proxyPort	Integer	代理服务器端口
├─ account	String	认证用户名
├─ password	String	认证密码
├─ ip	String	该出口对应的实际出口 IP (Exit IP)
├─ regionCn	String	归属地（中文）
├─ regionEn	String	归属地（英文）
├─ identifier	String	产品类型标识（如：StaticNativeProxy）
├─ expireTime	String	到期时间
├─ status	Integer	状态 (1: 正常, 2: 已过期)
├─ duration	Integer	时长
msg	String	提示信息

响应示例:

{
    "code": 0,
    "data": {
        "list": [
            {
                "proxyId": 803122365952069,
                "orderNo": "M*****",
                "proxyIp": "****",
                "proxyPort": 1337,
                "account": "************",
                "password": ""************",",
                "ip": "*****",
                "identifier": "StaticNativeProxy",
                "regionCn": "香港",
                "regionEn": "HK",
                "expireTime": "2026-06-07 11:32:58",
                "status": 1,
                "duration": 30
            }
        ],
        "total": 1
    },
    "msg": "success"
}