API запроса заказа
Вы предоставляете API для запроса заказов: когда клиент спрашивает о заказе, мы вызываем его с подписью. Данные заказов у нас не хранятся.
В настройках бота в панели управления укажите адрес для запроса заказов. Когда покупатель спрашивает о заказе, мы отправляем запрос:
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 日送达"
}
]
}
Эта страница была полезной?
Обновлено:
