API de consultation des commandes

Vous fournissez un endpoint de consultation des commandes ; lorsqu'un client demande sa commande, nous l'appelons avec une signature, et les données de commande ne sont pas stockées chez nous.

Dans l'interface d'administration, sous « Paramètres du robot », renseignez l'adresse de consultation des commandes. Lorsqu'un client pose une question sur une commande, nous envoyons la requête suivante :

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

{"user_id": "u_123", "order_no": "A1001"}
  • order_no peut être null, ce qui signifie qu'il faut rechercher la commande la plus récente de ce client.
  • Vérification de la signature : hex(HMAC-SHA256(签名密钥, "{X-AICS-Timestamp}.{原始请求体}")) doit être identique à la valeur qui suit v1=, et l'horodatage doit avoir moins de 5 minutes. La vérification doit impérativement se faire sur les octets du corps de requête d'origine, sans analyser le JSON puis le re-sérialiser.
  • Ne renvoyez que les commandes appartenant à ce user_id. Délai d'expiration : 8 secondes.

Format de retour (seuls les champs ci-dessous sont transmis à l'AI, les autres sont ignorés) :

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

Cette page vous a-t-elle été utile ?

Dernière mise à jour: