API tra cứu đơn hàng

Bạn cung cấp API tra cứu đơn hàng; khi khách hỏi về đơn hàng, chúng tôi sẽ gọi API kèm chữ ký, còn dữ liệu đơn hàng thì không lưu tại hệ thống của chúng tôi.

Điền địa chỉ truy vấn đơn hàng trong mục「Cài đặt robot」ở trang quản trị. Khi khách hàng hỏi về đơn hàng, chúng tôi sẽ gửi yêu cầu:

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

{"user_id": "u_123", "order_no": "A1001"}
  • order_no có thể là null, nghĩa là truy vấn đơn hàng gần nhất của khách hàng này.
  • Xác minh chữ ký: giá trị hex(HMAC-SHA256(签名密钥, "{X-AICS-Timestamp}.{原始请求体}")) phải trùng với giá trị đứng sau v1=, và dấu thời gian phải nằm trong vòng 5 phút. Bắt buộc xác minh chữ ký bằng byte gốc của phần thân yêu cầu, không được phân tích JSON rồi tuần tự hóa lại.
  • Chỉ trả về đơn hàng của chính user_id này. Thời gian chờ tối đa 8 giây.

Định dạng trả về (chỉ những trường dưới đây được chuyển cho AI, các trường khác sẽ bị bỏ qua):

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

Trang này có hữu ích không?

Cập nhật lần cuối: