API de consulta de pedidos

Você fornece uma API para consultar pedidos; quando o cliente pergunta sobre um pedido, nós chamamos com assinatura, e os dados do pedido não ficam armazenados conosco.

No painel de administração, em «Configurações do robô», preencha o endereço de consulta de pedidos. Quando um cliente perguntar sobre um pedido, faremos a seguinte requisição:

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

{"user_id": "u_123", "order_no": "A1001"}
  • order_no pode ser null, o que indica a consulta dos pedidos mais recentes deste cliente.
  • Verificação da assinatura: hex(HMAC-SHA256(签名密钥, "{X-AICS-Timestamp}.{原始请求体}")) deve ser igual ao valor que vem depois de v1=, e o timestamp deve estar dentro de 5 minutos. A verificação deve ser feita com os bytes originais do corpo da requisição; não analise o JSON e depois o serialize novamente.
  • Retorne apenas os pedidos do próprio user_id. Timeout de 8 segundos.

Formato de retorno (apenas os campos abaixo serão passados para a IA; os demais campos serão descartados):

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

Esta página foi útil?

Última atualização: