API de consulta de pedidos
Tú proporcionas un endpoint para consultar pedidos; cuando los clientes preguntan por un pedido, lo llamamos con firma y los datos del pedido no se almacenan en nuestro sistema.
En el panel de administración, en «Configuración del bot», introduce la dirección de consulta de pedidos. Cuando un cliente pregunte por su pedido, haremos la siguiente solicitud:
POST {你的订单接口}
Content-Type: application/json
X-AICS-Timestamp: 1761120000
X-AICS-Signature: v1=<hex>
{"user_id": "u_123", "order_no": "A1001"}
order_nopuede sernull, lo que indica que se consultan los pedidos más recientes de este cliente.- Verificación de firma:
hex(HMAC-SHA256(签名密钥, "{X-AICS-Timestamp}.{原始请求体}"))debe coincidir con el valor que aparece después dev1=, y la marca de tiempo debe estar dentro de los 5 minutos. La verificación debe hacerse con los bytes del cuerpo original de la solicitud; no analices el JSON y luego lo vuelvas a serializar. - Devuelve únicamente los pedidos del propio
user_id. Tiempo de espera: 8 segundos.
Formato de respuesta (solo los siguientes campos se entregan a la AI; los demás se descartan):
{
"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 日送达"
}
]
}
¿Te ha resultado útil esta página?
Última actualización:
