产品介绍 / 云服务器IP / API接口 / 查询订单
查询订单
推荐阅读时长：3分钟订单查询接口用于获取当前登录用户的云服务器IP订单。路由内部固定产品 ID 为 2，无需额外传入 productId。
接口信息
| 请求方式 | POST |
|---|---|
| 接口路径 | /api/v1/cloud/orderList |
| 鉴权要求 | Authorization: Bearer {token} |
| Content-Type | application/json |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
orderNo | string | 否 | 订单编号，不传则查询云服务器IP全部订单。 |
page | integer | 否 | 页码，默认 1。 |
limit | integer | 否 | 每页数量，默认 10。 |
请求示例
{
"orderNo": "NOR66aabbccddeef",
"page": 1,
"limit": 10
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
data.items | array | 订单列表。 |
data.total | integer | 订单总数。 |
data.page | integer | 当前页码。 |
order_no | string | 订单编号。 |
band | integer | 带宽。 |
server | string | 代理服务器地址，格式为 host:port。 |
province / city | string | 省份和城市。 |
username / password | string | 代理账号和密码。 |
start_time / end_time | string | 订单开始和到期时间。 |
status | integer | 订单状态。 |
area | string | 地区。 |
isp | string | 运营商。 |
pid | integer | 产品 ID，云服务器IP为 2。 |
node_status | integer | 节点状态。 |
响应示例
{
"code": 200,
"data": {
"items": [
{
"order_no": "NOR66aabbccddeef",
"band": 5,
"server": "127.0.0.1:8000",
"province_code": null,
"province": "广东",
"project_id": 1,
"city_code": null,
"city": "深圳",
"username": "proxy_user",
"password": "proxy_pwd",
"start_time": "2026-07-27 10:00:00",
"end_time": "2026-08-27 10:00:00",
"status": 1,
"area": "广东-深圳",
"isp": "电信",
"pid": 2,
"node_status": 1
}
],
"total": 1,
"page": 1
},
"msg": "获取订单列表成功"
}建议：业务系统可定时查询
end_time、status 和 node_status，用于续费提醒和异常监控。
