API zapytań o zamówienia

Udostępniasz endpoint do sprawdzania zamówień — gdy klient pyta o zamówienie, wywołujemy go z podpisem, a dane zamówień nie są przechowywane po naszej stronie.

W panelu administracyjnym w „Ustawieniach bota” podaj adres zapytań o zamówienia. Gdy klient pyta o zamówienie, wysyłamy następujące żądanie:

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

{"user_id": "u_123", "order_no": "A1001"}
  • order_no może mieć wartość null, co oznacza zapytanie o najnowsze zamówienia tego klienta.
  • Weryfikacja podpisu: hex(HMAC-SHA256(签名密钥, "{X-AICS-Timestamp}.{原始请求体}")) musi być zgodna z wartością po v1=, a znacznik czasu musi mieścić się w 5 minutach. Do weryfikacji podpisu trzeba użyć bajtów oryginalnego ciała żądania; nie należy parsować JSON, a następnie go serializować.
  • Zwracaj wyłącznie zamówienia należące do tego user_id. Limit czasu wynosi 8 sekund.

Format odpowiedzi (do AI trafiają tylko poniższe pola, pozostałe są odrzucane):

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

Czy ta strona była pomocna?

Ostatnia aktualizacja: