您可在此查询顾客与卖家的Q&A。卖家可通过该API查询在售商品的咨询记录。
查询时间段最长可设置为7天。
路径
GET
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/onlineInquiries
示例
请求参数
|
名称 |
必须 |
数据类型
|
描述 |
|
vendorId |
O |
String |
卖家ID |
链接请求参数
|
Name |
Required |
Type |
Description |
|||||||||||||
|
vendorId |
O |
String |
卖家ID |
|||||||||||||
|
answeredType |
O |
String |
Answer status
|
|||||||||||||
|
inquiryStartAt |
|
String |
查询开始日期：格式: yyyy-MM-dd 最长查询日期间隔为一周。 您可查询该时间段内的所有咨询记录（inquiryEndAt -inquiryStartAt < = 7days）。 |
|||||||||||||
|
inquiryEndAt |
|
String |
查询结束日期；格式: yyyy-MM-dd |
|||||||||||||
|
pageNum |
|
Number |
当前页 默认值: 1 |
|||||||||||||
|
pageSize |
|
Number |
页面大小 默认值: 10; 最大: 50 |
|||||||||||||
请求体
无
返回消息
|
Name |
Type |
Description |
||||||
|
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 |
查询时间 "2015-05-18 17:37:39" |
||||
|
|
|
orderIds |
List |
订单号 [16000009476673] |
||||
|
|
|
buyerEmail |
String |
提问顾客的邮箱地址 未使用/则会显示空值(“”) |
||||
|
|
|
commentDtoList |
Array |
问题回复 |
||||
|
|
|
|
inquiryCommentId |
Number |
Reply ID |
|||
|
|
|
|
inquiryId |
Number |
Question ID |
|||
|
|
|
|
content |
String |
问题回复内容 |
|||
|
|
|
|
inquiryCommentAt |
String |
回复时间 "2015-05-27 10:38:32" |
|||
|
|
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": "2019-06-25 01:10:04",
"orderIds": [
19000041361951
],
"buyerEmail": "",
"commentDtoList": [
{
"inquiryCommentId": 36881065,
"inquiryId": 39352323,
"content": "고객님 안녕하세요. OOO 입니다. 입금확인되었고 포장하여 금일 출고하겠습니다. 감사합니다.",
"inquiryCommentAt": "2019-06-25 10:06:38"
}
]
},
{
"inquiryId": 39352273,
"productId": 212844716,
"sellerProductId": 718482283,
"sellerItemId": 1699726710,
"vendorItemId": 4675663991,
"content": "스판이 강한가요?",
"inquiryAt": "2019-06-25 01:05:51",
"orderIds": [],
"buyerEmail": "",
"commentDtoList": [
{
"inquiryCommentId": 36885408,
"inquiryId": 39352273,
"content": "고객님 안녕하세요. OOO 입니다. 문의주신 제품 스판이 좋은 제품이긴하오나 개개인마다 생각이 다르기 때문에 개인차 있습니다 . 구매시 참고 부탁드립니다 . 감사합니다.",
"inquiryCommentAt": "2019-06-25 11:07:10"
}
]
},
{
"inquiryId": 39352362,
"productId": 130048576,
"sellerProductId": 375487954,
"sellerItemId": 910365921,
"vendorItemId": 3929087307,
"content": "언제도착입니까? 21일도착예정인데 준비중이고\r\n문의해도 답변없고 취소도 안되고\r\n환불해줘요",
"inquiryAt": "2019-06-25 01:13:58",
"orderIds": [
5000041411986
],
"buyerEmail": "",
"commentDtoList": [
{
"inquiryCommentId": 36885330,
"inquiryId": 39352362,
"content": "고객님 안녕하세요. OOO 입니다. 업체에서 확인되는 고객님 주문날짜는 6월24일이며 금일 출고요청된것으로 확인됩니다. 송장은 출고일 저녁 자동 등록되며 혹 구입일이 6월24일 이전일 경우 구매하신 쿠팡고객센터 1577-7011로 문의 부탁드립니다. 감사합니다. ",
"inquiryCommentAt": "2019-06-25 11:06:35"
}
]
}
],
"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