订单查询接口
你提供一个查订单的接口,顾客问订单时我们带签名调用,订单数据不在我们这里保存。
在后台「机器人设置」填写订单查询地址。顾客问订单时我们会请求:
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=后面的值相同,且时间戳在 5 分钟内。必须用原始请求体字节验签,不要解析 JSON 后再序列化。 - 只返回这个
user_id自己的订单。超时 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 日送达"
}
]
}
这篇文档有帮助吗?
最后更新:
