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=1URL API Name
GET_CUSTOMER_SERVICE_REQUEST
# 03
Path 파라미터
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 판매자 ID
|
| vendorId* | string | 판매자 ID
|
# 04
Query 파라미터
| Name | Type | Description | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| answeredType* | string | 답변 상태
| ||||||||
| inquiryStartAt* | string | 조회시작일, 형식: yyyy-MM-dd 최대 조회일 간격은 일주일입니다. 해당 조회 기간내의 모든 상담을 조회할 수 있습니다 (inquiryEndAt - inquiryStartAt < = 7days). | ||||||||
| inquiryEndAt* | string | 조회종료일, 형식: yyyy-MM-dd
| ||||||||
| pageNum | number | 현재 페이지 기본값 : 1 | ||||||||
| pageSize | number | 페이지 크기 기본값 : 10, 최대값 : 50 |
# 05
응답 본문
응답 메시지
| Name | Type | Description |
|---|---|---|
| code | integer | 서버 응답 코드
|
| message | string | 서버 응답 메시지
|
| data | object | 조회 결과
|
| 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 | |
| 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 | |
| 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 | 코드 | 메시지 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
오류 사양
| HTTP | 유형 | 오류 메시지 | 해결 방법 |
|---|---|---|---|
| 400 | 400 (요청변수확인) | time interval needs to be less than or equal to 7 days, pattern should be yyyy-MM-dd | 조회기간이 7일 이하 인지 확인합니다. |
| 400 | 400 (타임설정확인) | Read timed out | 설정한 조회기간(1일), 페이지 크기값(10)으로 재설정 후 재요청 합니다. 목록데이터가 많아 타임아웃이 발생할 경우 X-EXTENDED-TIMEOUT 설정값을 늘린 후 재요청합니다. *관련 FAQ 링크 |
| 400 | 400 (요청변수확인) | Invalid vendor ID | 올바른 판매자 ID (vendorId)를 입력했는지 확인합니다. |