静态 IP 下单 (Create Order)

1. 接口描述

根据资源类型、区域及数量批量创建静态代理订单。支持在一个请求中为多个不同区域（Region）下单，接口将返回生成的订单编号列表。

• 请求方式：POST
• 接口地址：https://api.cueip.com/api/static-proxy/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)

字段名	类型	是否必填	描述	示例
identifier	String	是	资源类型唯一标识符	StaticISPProxy
duration	Integer	是	购买时长（单位：天）	30
data	Array	是	下单详情列表	-
└ region	String	是	区域代码（通过节点列表接口获取）	my
└ count	Integer	是	该区域购买的 IP 数量	1

4. 请求示例

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

{
    "identifier": "StaticISPProxy",
    "data": [
        {
            "region": "hk",
            "count": 1
        },
        {
            "region": "gb",
            "count": 2
        }
    ],
    "duration": 30
}

5. 响应参数说明

成功响应 (200 OK)

字段名	类型	描述
code	Integer	状态码，0 表示成功
data	Object	订单结果数据
├ orderNo	String	生成的订单编号
├ status	String	业务状态描述
├ totalOrders	Integer	本次创建的订单总数
├ totalCount	Integer	本次采购的 IP 总数量
├ length	Integer	购买时长（天）
msg	String	提示信息

响应示例

{
  "code": 0,
  "data": {
    "orderNo": "MO202604241234567890123",
    "status": "success",
    "message": "批量订单创建成功",
    "identifier": "StaticISPProxy",
    "totalOrders": 2,
    "totalCount": 3,
    "length": 30,
    "orderDetails": [
      {
        "region": "my",
        "count": 1
      },
      {
        "region": "us-clf",
        "count": 2
      }
    ]
  },
  "msg": "success"
}