查询订单

GET 
/order/:order_id

通过 UUID 获取特定订单的详情。在创建购买后，用它跟踪订单进度。

订单状态（始终为大写）：

• PENDING——订单已创建并已付款；能量或带宽委托进行中
• COMPLETED——能量或带宽已委托（delegation_txids 通常会列出链上委托交易 ID）
• FAILED——订单未能完成，并已自动退款（见 error_message）

通过 API 下的订单从 PENDING 变为 COMPLETED 或 FAILED。直接从钱包付款的订单还可能显示 AWAITING_PAYMENT 或 PROCESSING。

请求

Responses

200

成功响应

401

X-API-Key 请求头缺失、无效或已撤销。detail 为纯字符串：API key required、Invalid API key 或 User not found。

403

账户已被封禁（纯字符串 detail：Account is blocked），或 ip_not_allowed——请求的来源 IP 不在该密钥的 IP 白名单内。

404

Order not found——订单不存在，或不属于你。detail 为纯字符串。

422

order_id 不是有效的 UUID——detail 为字段错误数组。

429

Rate limit exceeded——你的账户每分钟请求超过 1,000 次（由该账户的所有 API 密钥与工作台会话共用）。detail 为纯字符串；等待 Retry-After 给出的秒数后再重试。

Response Headers

Retry-After

距离限流窗口重置的秒数。