全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
查询评价列表
接口地址： http://api.vv-tool.com/tool/erps/ks-list-get
接口介绍： 查询当前商家的评价列表点击查看详情
必须用户授权 : 需要用户的授权，才能拿到被授权的数据
请求方式： POST
返回格式： JSON
接口收费： 扣账户余额
频率限制： 10 次/秒
请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
| 参数名 | 类型 | 必须 | 示例值 | 详情描述 |
|---|---|---|---|---|
| shop_id | String | 是 | 13211 | 店铺 id(可在快手小店获取) |
| outOrderNo | String | 否 | 2040400016317056 | 订单 id |
| serviceScore | List | 否 | [2] | 服务评分 |
| qualityScore | List | 否 | [5] | 质量评分 |
| logisticsScore | List | 否 | [4] | 物流评分 |
| offset | Integer | 是 | 2 | 偏移量。 页数*limit |
| limit | Integer | 是 | 10 | 每页返回最大数目，最大 20 |
| createTimeFrom | Long | 否 | 1605234213381 | 评论创建时间 from |
| createTimeTo | Long | 否 | 1605234215581 | 评论创建时间 to |
| classifyType | Integer | 否 | 1 | 分类类型 UNKNOWN_CLASSIFY_TYPE = 0; // 全部 REPLIED_CLASSIFY = 1; // 已回复 NO_REPLIED_CLASSIFY = 2; // 未回复 ATTACHED_CLASSIFY = 3; // 有追评 COMPLAIN_CLASSIFY = 4; // 已投诉 |
| outItemId | Long | 否 | 388565022056 | 商品 id |
| itemTitle | String | 否 | 印花 T 恤 | 商品名称 |
| rootCommentTag | List | 否 | [] | 主评论的标签 |
| complainStatus | Integer | 否 | 1 | 评论申诉状态 NO_COMPLAIN_YET = 0; // 暂无投诉 AUDITING_COMPLAIN = 1; // 投诉审核中 THROUGH_COMPLAIN = 2; // 投诉审核通过 REJECT_COMPLAIN = 3; // 投诉审核拒绝 MODIFY_COMPLAIN = 4; // 审核驳回待修改 UNKNOWN_COMPLAIN_STATUS = 5; // 全部 |
| vvtype | int | 否 | 1 | 普通版 1，不传默认 1，增强版 2，增强版的需要传参 2 |
请求示例
{
}
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| result | Integer | 1 | 返回码 |
| error_msg | String | SUCCESS | 返回码描述 |
| data | CommentData | 1 | 1 |
| commentId | Long | “16693” | 1 |
| withholding_money | Integer | 该接口扣费金额（点券） |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1469,
"time": 1617270403,
"data": {
"result": 1,
"error_msg": "SUCCESS",
"data": {
"commentId": "“16693”"
}
"withholding_money":4
}
}
响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API 调用次数不足，请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |