根据订单查询 IP 列表 (Get IPs by Order)
1. 接口描述
通过订单编号(Order Number)检索该订单成功交付的所有 IP 唯一标识符(ID)。该接口返回的 ID 列表是进一步获取 IP 具体属性(如 IP 地址、端口、归属地明细)或进行 IP 级别续费的核心凭证。
- 请求方式:
POST - 接口地址:
https://api.cueip.com/api/static-proxy/ips-by-order - 内容类型:
application/json
2. 请求头规范 (Header)
所有请求必须包含以下安全校验字段
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| X-APP-ID | String | 是 | 应用唯一标识 (appId) | 10001 |
| X-NONCE | String | 是 | 随机数 | k9m2Pq7wL1 |
| X-TIMESTAMP | Long | 是 | 当前 Unix 时间戳 (秒) | 1713165000 |
| X-SIGN | String | 是 | 动态签名 | d3b1... |
签名生成逻辑请参考:签名生成指南
3. 请求参数说明 (Body)
| 字段名 | 类型 | 是否必填 | 描述 | 示例 |
|---|---|---|---|---|
| orderNo | String | 是 | 订单编号 | MO202604231536109260001 |
4. 请求示例
http
POST /api/static-proxy/ips-by-order
Host: api.cueip.com
Content-Type: application/json
{
"orderNo": "MO202604231536109260001"
}5. 响应参数说明
成功响应 (200 OK)
| 字段名 | 类型 | 描述 |
|---|---|---|
code | Integer | 状态码,0 表示成功 |
data | Array | IP 详细属性对象 |
├ id | Integer | ID |
├ proxyId | String | 系统生成的 IP 唯一编号 (业务标识) |
├ orderNo | String | 所属订单编号 |
├ proxyIp | String | 代理服务器 IP/域名 |
├ proxyPort | Integer | 代理服务器端口 |
├ account | String | 认证用户名 |
├ password | String | 认证密码 |
├ ip | String | 该出口对应的实际出口 IP (Exit IP) |
├ regionCn | String | 归属地(中文) |
├ regionEn | String | 归属地(英文) |
├ expireTime | String | 到期时间 (格式:yyyy-MM-dd HH:mm:ss) |
├ status | Integer | 状态 (1: 正常, 2: 已过期) |
msg | String | 提示信息 |
响应示例
json
{
"code": 0,
"data": [
{
"proxyId": 87,
"orderNo": "MO202604231816190410000",
"proxyIp": "69.17.5.72",
"proxyPort": 1337,
"account": "n9u1h8chi3v3",
"password": "py5ebe6rymxw",
"ip": "178.95.159.100",
"identifier": "StaticISPProxy",
"regionCn": "马来西亚",
"regionEn": "Malaysia",
"expireTime": "2026-05-23 15:36:45",
"status": 1
}
],
"msg": "success"
}