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
請求引數
路徑引數
| 名稱 | 是否必須 | 型別 | 描述 |
| vendorId | O | String | 賣家ID |
查詢引數
| 名稱 | 是否必須 | 型別 | 描述 | ||||||||
| vendorId | O | String | 賣家ID | ||||||||
| answeredType | O | String |
Answer status
|
||||||||
| inquiryStartAt | String |
查詢開始日期 (符合ISO-8601標準) 格式： YYYY-MM-DD 最長查詢日期間隔為一週。 您可查詢該時間段內的所有諮詢記錄（inquiryEndAt -inquiryStartAt < = 7days）。 |
|||||||||
| inquiryEndAt | String |
查詢結束日期 (符合ISO-8601標準) 格式： YYYY-MM-DD |
|||||||||
| pageNum | Number |
當前頁 預設值: 1 |
|||||||||
| pageSize | Number |
頁面大小 預設值: 10; 最大: 50 |
請求體引數
無
返回訊息
| 名稱 | 狀態 | 描述 | |||
| code | Number | 伺服器響應碼 | |||
| message | String | 伺服器響應訊息 | |||
| data | Object | 查詢結果 | |||
| content | Array | 結果 | |||
| inquiryId | Number |
Question Id 問題ID |
|||
| productId | Number | 顯示商品ID | |||
| sellerProductId | Number | 註冊商品ID | |||
| sellerItemId | Number | sellerItemId | |||
| vendorItemId | Number | 屬性ID | |||
| content | String | 問題內容 | |||
| inquiryAt | String |
查詢時間 (符合ISO-8601标准) 格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
|||
| orderIds | List |
訂單號 [16000009476673] |
|||
| commentDtoList | Array | 問題回覆 | |||
| inquiryCommentId | Number | Reply ID | |||
| inquiryId | Number | Question ID | |||
| content | String | 問題回覆內容 | |||
| inquiryCommentAt | String |
回覆時間 (符合ISO-8601標準) 格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
|||
| pagination | Object | Pagination information | |||
| currentPage | Number |
當前頁 預設值: 1 |
|||
| totalPages | Number | 總頁數 | |||
| totalElements | Number | 總諮詢數 | |||
| countPerPage | Number | 每頁諮詢數 | |||
返回訊息例子
{
"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
}
}
}
錯誤資訊
|
HTTP狀態程式碼（錯誤型別）
|
錯誤資訊 | 解決方案 |
| 400 (確認請求引數) | time interval needs to be less than or equal to 7 days， pattern should be yyyy-MM-dd | 請確認查詢時間段是否小於7天。 |
| 400 (確認請求引數) | Read timed out | 將查詢時間段及頁面大小數值分別設定為查詢時間段（1天）和頁面大小數值（10）後再次傳送請求。若因陣列資料量大而發生超時，請增加 X-EXTENDED-TIMEOUT 設定值後再次傳送請求。* FAQ連結 |
| 400 (確認請求引數) | Invalid vendor ID | 請確認輸入的賣家ID(vendorId)是否正確。 |
介面名稱
GET_CUSTOMER_SERVICE_REQUEST