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= และ timestamp ต้องอยู่ในช่วง 5 นาที ต้องตรวจสอบลายเซ็นโดยใช้ไบต์ของ request body ต้นฉบับ ห้าม parse JSON แล้ว serialize ใหม่
  • ส่งคืนเฉพาะคำสั่งซื้อที่เป็นของ user_id นี้เท่านั้น timeout 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 日送达"
    }
  ]
}

หน้านี้มีประโยชน์ไหม?

อัปเดตล่าสุด: