API di ricerca ordini

Fornisci un endpoint per la ricerca degli ordini: quando i clienti chiedono informazioni su un ordine, lo chiamiamo con una firma; i dati degli ordini non vengono salvati da noi.

Nel back office, in «Impostazioni robot», inserisci l'URL per la ricerca degli ordini. Quando un cliente chiede informazioni su un ordine, invieremo questa richiesta:

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

{"user_id": "u_123", "order_no": "A1001"}
  • order_no può essere null, il che significa che si vogliono cercare gli ordini più recenti di questo cliente.
  • Verifica della firma: hex(HMAC-SHA256(签名密钥, "{X-AICS-Timestamp}.{原始请求体}")) deve coincidere con il valore che segue v1=, e il timestamp deve rientrare nei 5 minuti. La verifica va eseguita sui byte del corpo originale della richiesta, senza analizzare il JSON e poi serializzarlo di nuovo.
  • Restituisci solo gli ordini appartenenti a questo user_id. Timeout: 8 secondi.

Formato della risposta (solo i campi seguenti vengono passati all'AI, gli altri vengono scartati):

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

Questa pagina ti è stata utile?

Ultimo aggiornamento: