Skip to content

根据订单查询 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-IDString应用唯一标识 (appId)10001
X-NONCEString随机数k9m2Pq7wL1
X-TIMESTAMPLong当前 Unix 时间戳 (秒)1713165000
X-SIGNString动态签名d3b1...

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

3. 请求参数说明 (Body)

字段名类型是否必填描述示例
orderNoString订单编号MO202604231536109260001

4. 请求示例

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

{
    "orderNo": "MO202604231536109260001"
}

5. 响应参数说明

成功响应 (200 OK)

字段名类型描述
codeInteger状态码,0 表示成功
dataArrayIP 详细属性对象
idIntegerID
proxyIdString系统生成的 IP 唯一编号 (业务标识)
orderNoString所属订单编号
proxyIpString代理服务器 IP/域名
proxyPortInteger代理服务器端口
accountString认证用户名
passwordString认证密码
ipString该出口对应的实际出口 IP (Exit IP)
regionCnString归属地(中文)
regionEnString归属地(英文)
expireTimeString到期时间 (格式:yyyy-MM-dd HH:mm:ss)
statusInteger状态 (1: 正常, 2: 已过期)
msgString提示信息

响应示例

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"
}