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_nopuò esserenull, 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 seguev1=, 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:
