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_nocó 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 sauv1=, 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_idnà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:
