訂單查詢 API

你提供一個查訂單的 API,顧客詢問訂單時我們會帶簽章呼叫,訂單資料不會保存在我們這裡。

在後台「機器人設定」填寫訂單查詢地址。顧客詢問訂單時我們會請求:

POST {你的订单接口}
Content-Type: application/json
X-AICS-Timestamp: 1761120000
X-AICS-Signature: v1=<hex>

{"user_id": "u_123", "order_no": "A1001"}
  • order_no 可能為 null,表示查詢這位顧客最近的訂單。
  • 驗簽:hex(HMAC-SHA256(签名密钥, "{X-AICS-Timestamp}.{原始请求体}")) 與 v1= 後面的值相同,且時間戳在 5 分鐘內。必須用原始請求體位元組驗簽,不要解析 JSON 後再序列化。
  • 只返回這個 user_id 自己的訂單。逾時 8 秒。

返回格式(只有下面這些欄位會交給 AI,其他欄位會被丟棄):

{
  "orders": [
    {
      "order_no": "A1001",
      "status": "shipped",
      "total": "59.00",
      "currency": "USD",
      "items": [{"name": "潜水自动机械表", "quantity": 1}],
      "tracking": {"carrier": "DHL", "number": "JD0146...", "url": "https://..."},
      "created_at": "2026-10-01T08:00:00Z",
      "note": "预计 10 月 25 日送达"
    }
  ]
}

這頁對你有幫助嗎?

最後更新: