주문 조회 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 日送达"
    }
  ]
}

이 페이지가 도움이 되었나요?

마지막 업데이트: