Bestellabfrage-API

Tragen Sie im Backend unter „Bot-Einstellungen“ die URL für die Bestellabfrage ein. Wenn Kundinnen und Kunden nach Bestellungen fragen, senden wir folgende Anfrage:

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

{"user_id": "u_123", "order_no": "A1001"}

• order_no kann null sein. Das bedeutet, dass die letzten Bestellungen dieser Kundin oder dieses Kunden abgefragt werden.
• Signaturprüfung: hex(HMAC-SHA256(签名密钥, "{X-AICS-Timestamp}.{原始请求体}")) muss mit dem Wert nach v1= übereinstimmen, und der Zeitstempel muss innerhalb von 5 Minuten liegen. Die Signaturprüfung muss mit den Bytes des ursprünglichen Request-Bodys erfolgen; parsen Sie das JSON nicht und serialisieren Sie es anschließend neu.
• Es werden nur die eigenen Bestellungen dieser user_id zurückgegeben. Timeout: 8 Sekunden.

Rückgabeformat (nur die folgenden Felder werden an die AI übergeben, alle anderen Felder werden verworfen):

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