静觅 崔庆才的个人站点 - Python爬虫教程

0%

获取 AceDataCloud 平台订单详情

作者 发表于 分类于 阅读次数： 本文字数： 2.8k 阅读时长 ≈ 3 分钟

通过订单 ID 获取单个订单的完整信息——比列表多出 application、service、package 等关联对象的完整字段，以及当前可用的 payment_url（仅 Pending 订单）。

ℹ️ 本接口属于 AceDataCloud 平台管理 API，统一前缀 https://platform.acedata.cloud/api/v1/。完整接口索引见获取 AceDataCloud 平台文档列表。

接口概览

项 内容
方法 GET
URL https://platform.acedata.cloud/api/v1/orders/{order_id}
鉴权 ✅ 需要账户令牌

⚠️ URL 不要带尾部斜杠——/orders/{id} 不是 /orders/{id}/。

鉴权说明（如何获取账户令牌）

请求头：

1
 
Authorization: Bearer platform-v1-92eb****629c

获取方式见管理 AceDataCloud 平台账户令牌。

路径参数

参数 类型 必填 说明
order_id UUID ✅ 订单 ID

请求示例

cURL

1
2
3
 
curl 'https://platform.acedata.cloud/api/v1/orders/fa927d12-3b04-4f51-bf2e-ec3a5a7d9b2c' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

Python

1
2
3
4
5
6
7
8
9
10
11
12
13
 
import requests

order_id = "fa927d12-3b04-4f51-bf2e-ec3a5a7d9b2c"
resp = requests.get(
    f"https://platform.acedata.cloud/api/v1/orders/{order_id}",
    headers={"authorization": "Bearer platform-v1-92eb****629c"},
    timeout=10,
)
order = resp.json()
print(f"订单: {order['service']['title']} - {order['package']['amount']} {order['service']['unit']}")
print(f"状态: {order['state']} - ¥{order['final_price']}")
if order['state'] == "Pending":
    print("⚠️ 订单未支付")

Node.js

1
2
3
4
5
 
const orderId = 'fa927d12-3b04-4f51-bf2e-ec3a5a7d9b2c'
const r = await fetch(`https://platform.acedata.cloud/api/v1/orders/${orderId}`, {
  headers: { authorization: 'Bearer platform-v1-92eb****629c' },
})
console.log(await r.json())

响应示例（HTTP 200）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
 
{
  "id": "fa927d12-3b04-4f51-bf2e-ec3a5a7d9b2c",
  "user_id": "89518d07-5560-4b05-92c1-667f3ddf6a4b",
  "application_id": "82f57141-2323-4453-8730-60f7d833a2da",
  "service_id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452",
  "package_id": "4add61f2-61db-4d1c-85b6-d4876ac122f0",
  "type": "Usage",
  "state": "Paid",
  "price": 63.2,
  "amount": 530.0,
  "currency": "CNY",
  "payment_method": "AliPay",
  "discount_rate": 1.0,
  "discount_amount": 0.0,
  "final_price": 63.2,
  "metadata": null,
  "tags": null,
  "paid_at": "2026-04-26T08:01:23Z",
  "expired_at": null,
  "refunded_at": null,
  "created_at": "2026-04-26T08:00:00Z",
  "updated_at": "2026-04-26T08:01:23Z",
  "service": {
    "id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452",
    "alias": "openai",
    "title": "OpenAI",
    "unit": "Credit"
  },
  "application": {
    "id": "82f57141-2323-4453-8730-60f7d833a2da",
    "remaining_amount": 100.0
  },
  "package": {
    "id": "4add61f2-61db-4d1c-85b6-d4876ac122f0",
    "type": "Usage",
    "price": 63.2,
    "amount": 530.0
  }
}

响应字段说明

字段含义同订单列表，额外展开 application / service / package 关联对象。

错误处理

HTTP code 含义
401 not_authenticated 缺少账户令牌
403 permission_denied 订单不属于你
404 not_found 订单不存在
500 — URL 末尾误加斜杠，去掉后重试

实用提示

  • 要拿支付链接：用支付 AceDataCloud 平台订单 接口而不是本接口——本接口只返回快照，不刷新付款链接。
  • 判断订单生效：用 state="Paid" 和 paid_at 一起判断。paid_at 写入后，Application 的 remaining_amount 一般在几秒内增加。
  • state="Pending" 超过 24 小时：建议轮询刷新订单状态 或直接放弃。

相关接口

相关文章