coupang
API 文件
商品 API品類 API品牌 API運輸 / 訂單 API退貨 API換貨 API促銷 / 優惠券物流資訊客服 / 諮詢結算CGF / CGF liteRocket Growth
GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/onlineInquiries2609170000

按商品查詢顧客諮詢

KRTW
# 01

簡介

按商品查詢顧客諮詢

# 02

詳細內容

API 適用的买方用户區域：韓國、台灣

您可在此查詢顧客與賣家的Q&A。賣家可透過該API查詢在售商品的諮詢記錄。

查詢時間段最長可設定為7天。

路徑

GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/onlineInquiries

範例端點

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/onlineInquiries?inquiryStartAt=2019-06-25&inquiryEndAt=2019-06-26&vendorId=A00012345&answeredType=NOANSWER&pageSize=10&pageNum=1
# 03

Path 參數

NameTypeDescription
vendorId*string
賣家ID
vendorId*string
賣家ID
vendorId*string
賣家ID
vendorId*string
賣家ID
# 04

Query 參數

NameTypeDescription
answeredType*string
Answer status
名稱 含義
ALL 檢視全部
ANSWERED 已回覆
NOANSWER 未回覆
inquiryStartAtstring
查詢開始日期 (符合ISO-8601標準)

格式： YYYY-MM-DD

最長查詢日期間隔為一週。 您可查詢該時間段內的所有諮詢記錄（inquiryEndAt -inquiryStartAt < = 7days）。
inquiryEndAtstring
查詢結束日期 (符合ISO-8601標準)

格式： YYYY-MM-DD
pageNumnumber
當前頁

預設值: 1
pageSizenumber
頁面大小

預設值: 10; 最大: 50
answeredType*string
Answer status
名稱 含義
ALL 檢視全部
ANSWERED 已回覆
NOANSWER 未回覆
inquiryStartAtstring
查詢開始日期 (符合ISO-8601標準)

格式： YYYY-MM-DD

最長查詢日期間隔為一週。 您可查詢該時間段內的所有諮詢記錄（inquiryEndAt -inquiryStartAt < = 7days）。
inquiryEndAtstring
查詢結束日期 (符合ISO-8601標準)

格式： YYYY-MM-DD
pageNumnumber
當前頁

預設值: 1
pageSizenumber
頁面大小

預設值: 10; 最大: 50
# 05

回應內容

回應訊息

NameTypeDescription
codeinteger
伺服器響應碼
messagestring
伺服器響應訊息
dataobject
查詢結果
content
data.content
object[]
結果
inquiryId
data.content[].inquiryId
integer
Question Id

問題ID
productId
data.content[].productId
integer
顯示商品ID
sellerProductId
data.content[].sellerProductId
integer
註冊商品ID
sellerItemId
data.content[].sellerItemId
integer
sellerItemId
vendorItemId
data.content[].vendorItemId
integer
屬性ID
content
data.content[].content
string
問題內容
inquiryAt
data.content[].inquiryAt
string
查詢時間 (符合ISO-8601标准)

格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
orderIds
data.content[].orderIds
object[]
訂單號

[16000009476673]
commentDtoList
data.content[].commentDtoList
object[]
問題回覆
inquiryCommentId
data.content[].commentDtoList[].inquiryCommentId
integer
Reply ID
inquiryId
data.content[].commentDtoList[].inquiryId
integer
Question ID
content
data.content[].commentDtoList[].content
string
問題回覆內容
inquiryCommentAt
data.content[].commentDtoList[].inquiryCommentAt
string
回覆時間 (符合ISO-8601標準)

格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm
pagination
data.pagination
object
Pagination information
currentPage
data.pagination.currentPage
integer
當前頁

預設值: 1
totalPages
data.pagination.totalPages
integer
總頁數
totalElements
data.pagination.totalElements
integer
總諮詢數
countPerPage
data.pagination.countPerPage
integer
每頁諮詢數

Response Example

{
  "code": 200,
  "message": "OK",
  "data": {
    "content": [
      {
        "inquiryId": 39352323,
        "productId": 231526161,
        "sellerProductId": 786583589,
        "sellerItemId": 1891732488,
        "vendorItemId": 4855652221,
        "content": "포장 3천원 입금하였습니다.",
        "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
        "orderIds": [
          19000041361951
        ],
        "commentDtoList": [
          {
            "inquiryCommentId": 36881065,
            "inquiryId": 39352323,
            "content": "고객님 안녕하세요. OOO 입니다. 입금확인되었고 포장하여 금일 출고하겠습니다. 감사합니다.",
            "inquiryCommentAt": "2025-01-15T14:17:13.973885-08:00"
          }
        ]
      },
      {
        "inquiryId": 39352273,
        "productId": 212844716,
        "sellerProductId": 718482283,
        "sellerItemId": 1699726710,
        "vendorItemId": 4675663991,
        "content": "스판이 강한가요?",
        "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
        "orderIds": [],
        "commentDtoList": [
          {
            "inquiryCommentId": 36885408,
            "inquiryId": 39352273,
            "content": "고객님 안녕하세요. OOO 입니다. 문의주신 제품 스판이 좋은 제품이긴하오나 개개인마다 생각이 다르기 때문에 개인차 있습니다 . 구매시 참고 부탁드립니다 . 감사합니다.",
            "inquiryCommentAt": "2025-01-15T14:17:13.973885-08:00"
          }
        ]
      },
      {
        "inquiryId": 39352362,
        "productId": 130048576,
        "sellerProductId": 375487954,
        "sellerItemId": 910365921,
        "vendorItemId": 3929087307,
        "content": "언제도착입니까? 21일도착예정인데 준비중이고\r\n문의해도 답변없고 취소도 안되고\r\n환불해줘요",
        "inquiryAt": "2025-01-15T14:17:13.973885-08:00",
        "orderIds": [
          5000041411986
        ],
        "commentDtoList": [
          {
            "inquiryCommentId": 36885330,
            "inquiryId": 39352362,
            "content": "고객님 안녕하세요. OOO 입니다. 업체에서 확인되는 고객님 주문날짜는 6월24일이며 금일 출고요청된것으로 확인됩니다. 송장은 출고일 저녁 자동 등록되며 혹 구입일이 6월24일 이전일 경우 구매하신 쿠팡고객센터 1577-7011로 문의 부탁드립니다. 감사합니다. ",
            "inquiryCommentAt": "2025-01-15T14:17:13.973885-08:00"
          }
        ]
      }
    ],
    "pagination": {
      "currentPage": 6,
      "totalPages": 102,
      "totalElements": 304,
      "countPerPage": 3
    }
  }
}
# 06

錯誤碼

HTTP代碼訊息
400HTTP_400Bad Request

錯誤說明

HTTP類型錯誤訊息解決方案
400400 (確認請求引數)

time interval needs to be less than or equal to 7 days， pattern should be yyyy-MM-dd

請確認查詢時間段是否小於7天。

400400 (確認請求引數)

Read timed out

將查詢時間段及頁面大小數值分別設定為查詢時間段（1天）和頁面大小數值（10）後再次傳送請求。若因陣列資料量大而發生超時，請增加 X-EXTENDED-TIMEOUT 設定值後再次傳送請求。* FAQ連結

400400 (確認請求引數)

Invalid vendor ID

請確認輸入的賣家ID(vendorId)是否正確。