注文照会API

注文を照会するAPIをご用意いただくと、お客様から注文に関するお問い合わせがあった際に署名付きで呼び出します。注文データは当社側では保存しません。

管理画面の「ボット設定」で注文照会URLを入力してください。顧客から注文について質問があった際、次のリクエストを送信します:

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 日送达"
    }
  ]
}

このページは役に立ちましたか?

最終更新: