API semakan pesanan

Anda menyediakan API untuk menyemak pesanan; apabila pelanggan bertanya tentang pesanan, kami memanggilnya dengan tandatangan, dan data pesanan tidak disimpan di pihak kami.

Di backend «Tetapan Bot», isi URL pertanyaan pesanan. Apabila pelanggan bertanya tentang pesanan, kami akan membuat permintaan:

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

{"user_id": "u_123", "order_no": "A1001"}
  • order_no mungkin null, yang bermaksud pertanyaan untuk pesanan terkini pelanggan ini.
  • Pengesahan tandatangan: hex(HMAC-SHA256(签名密钥, "{X-AICS-Timestamp}.{原始请求体}")) mestilah sama dengan nilai selepas v1=, dan cap masa mesti dalam tempoh 5 minit. Mesti sahkan tandatangan menggunakan bait badan permintaan asal, jangan huraikan JSON kemudian bersiri semula.
  • Hanya kembalikan pesanan milik user_id ini sahaja. Had masa 8 saat.

Format pulangan (hanya medan berikut akan diserahkan kepada AI; medan lain akan dibuang):

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

Adakah halaman ini membantu?

Kemas kini terakhir: