API 开发者文档（六）：订单模块接口

模块概述

订单模块用于查询订单与通过 API 创建待付款订单，对应权限范围 order.list、order.detail、order.create。

订单列表查询

请求参数

响应参数（data）

订单状态枚举

请求示例

GET /api.php/v1/order/list?page=1&per_page=10 HTTP/1.1
Host: www.dapengcloud.com
X-Access-Key: AKID8F2C4A91B7D34E6F0A1C2B3D
X-Timestamp: 1761000000
X-Signature: 0c6a9e2f4b8d1a3c5e7f9012b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f

成功响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "list": [
      {
        "id": 8,
        "order_number": "ORD202610210001",
        "status": "pending",
        "total": "59.00",
        "currency": "CNY",
        "created_at": "2026-10-21 10:12:33"
      }
    ],
    "page": 1,
    "per_page": 10
  }
}

失败响应示例

{
  "code": 401,
  "message": "签名验证失败",
  "data": null,
  "error": { "code": "auth_failed" }
}

订单详情查询

请求参数

响应参数（data）

请求示例

GET /api.php/v1/order/detail?id=8 HTTP/1.1
Host: www.dapengcloud.com
X-Access-Key: AKID8F2C4A91B7D34E6F0A1C2B3D
X-Timestamp: 1761000000
X-Signature: 1f3a5c7e9b2d4f6081a3c5e7f9b2d4f6081a3c5e7f9b2d4f6081a3c5e7f9b2d

成功响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "order": {
      "id": 8,
      "order_number": "ORD202610210001",
      "parent_order_id": null,
      "client_id": 1001,
      "status": "pending",
      "total": "59.00",
      "currency": "CNY",
      "notes": "API 下单",
      "ip": "203.0.113.10",
      "created_at": "2026-10-21 10:12:33",
      "updated_at": "2026-10-21 10:12:33"
    },
    "items": [
      {
        "id": 15,
        "order_id": 8,
        "product_id": 3,
        "product_name": "标准型 VPS",
        "cycle": "month",
        "unit_price": "59.00",
        "quantity": 1,
        "amount": "59.00",
        "config_snapshot": null
      }
    ]
  }
}

失败响应示例

{
  "code": 500,
  "message": "order not found",
  "data": null,
  "error": { "code": "controller_error" }
}

订单不存在、不属于当前客户或 id 缺失时，服务端以 500 controller_error 返回具体原因（见错误码对照表说明）。

API 快速下单

请求参数（JSON Body）

响应参数（data）

业务说明

• 服务端会重新读取产品价格，不信任请求中传入的任何金额，避免价格篡改。
• 创建的订单状态为 pending（待付款），同时生成一条订单明细；不会自动扣款、不会自动开通。
• 下单成功会触发系统订单事件，客户将收到对应的站内通知（如已配置）。
• 该接口不具备幂等性：重复调用会创建多笔订单。请勿在超时后盲目重试，应先通过 order/list 核实是否已创建。

请求示例

POST /api.php/v1/order/create HTTP/1.1
Host: www.dapengcloud.com
Content-Type: application/json; charset=utf-8
X-Access-Key: AKID8F2C4A91B7D34E6F0A1C2B3D
X-Timestamp: 1761000000
X-Signature: 7b1d3f5a9c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d
{"product_id":3,"cycle":"month"}

成功响应示例

{
  "code": 0,
  "message": "ok",
  "data": {
    "order_id": 8,
    "total": 59,
    "currency": "CNY"
  }
}

失败响应示例

{
  "code": 500,
  "message": "product not available",
  "data": null,
  "error": { "code": "controller_error" }
}

产品不存在、已下架，或指定周期未配置价格时返回该错误；product_id 缺失时 message 为 product_id required。