全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

搜索评价信息


接口地址: http://api.vv-tool.com/tool/erps/traderates


接口介绍: 查询授权店铺的商品的评价信息 点击查看详情


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 扣账户余额


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

名称 类型 必须 示例值 描述
shop_id String true 123456789 店铺 ID
fields String[] true tid,oid,role,reply,num_iid 需返回的字段列表。可选值:TradeRate 结构中的所有字段,多个字段之间用“,”分隔
rate_type String true get 评价类型。可选值:get(得到),give(给出)参数填 get 下面必须填 buyer(买家) 参数填 give 下面必须填 seller(卖家)
role String true seller 评价者角色即评价的发起方。可选值:seller(卖家),buyer(买家)。 当 give buyer 以买家身份给卖家的评价; 当 get seller 以买家身份得到卖家给的评价; 当 give seller 以卖家身份给买家的评价; 当 get buyer 以卖家身份得到买家给的评价。
result String false good 评价结果。可选值:good(好评),neutral(中评),bad(差评)
page_no Number false 1 页码。取值范围:大于零的整数最大限制为 200; 默认值:1
page_size Number false 100 每页获取条数。默认值 40,最小值 1,最大值 150。
start_date Date false 2011-01-01 00:00:00 评价开始时。如果只输入开始时间,那么能返回开始时间之后的评价数据。
end_date Date false 2011-01-02 00:00:00 评价结束时间。如果只输入结束时间,那么全部返回所有评价数据。
tid Number false 123456 交易订单 id,可以是父订单 id 号,也可以是子订单 id 号
use_has_next Boolean false true 是否启用 has_next 的分页方式,如果指定 true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取评价信息,效率在原有的基础上有 80% 的提升。
num_iid Number false 1234 商品的数字 ID
vvtype int false 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2

请求示例

fields:tid,oid,role,nick,result,created,rated_nick,item_title,item_price,content,reply,num_iid
rate_type:get
role:seller
shop_id:123

请求代码示例

cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/traderates' \
--header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx' \
--header 'Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D' \
--form 'fields="tid,oid,role,nick,result,created,rated_nick,item_title,item_price,content,reply,num_iid"' \
--form 'rate_type="get"' \
--form 'role="buyer"' \
--form 'shop_id="123"'
PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/traderates',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('fields' => 'tid,oid,role,nick,result,created,rated_nick,item_title,item_price,content,reply,num_iid','rate_type' => 'get','role' => 'buyer','shop_id' => '123'),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("fields","tid,oid,role,nick,result,created,rated_nick,item_title,item_price,content,reply,num_iid")
  .addFormDataPart("rate_type","get")
  .addFormDataPart("role","buyer")
  .addFormDataPart("shop_id","123")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/traderates")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Cookie", "__yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称 类型 示例值 描述
tid Number 1234 交易 ID
oid Number 1234 子订单 ID
role String seller 评价者角色。可选值:seller(卖家),buyer(买家)
nick String 张三 评价者昵称
result String good 评价结果,可选值:good(好评),neutral(中评),bad(差评)
created Date 2010-01-01 13:30:05 评价创建时间,格式:yyyy-MM-dd HH:mm:ss
rated_nick String 李四 被评价者昵称
item_title String cdma 冲值卡 商品标题
item_price Price 200.07 商品价格,精确到 2 位小数;单位:元。如:200.07,表示:200 元 7 分
content String 很快、很好 评价内容,最大长度:500 个汉字
reply String 谢谢 评价解释,最大长度:500 个汉字
num_iid Number 1500006394531 商品的数字 ID
valid_score Boolean true 评价信息是否用于记分,可取值:true(参与记分)和 false(不参与记分)
total_results Number 50 搜索到的评价总数。相同的查询时间段条件下,最大只能获取总共 1500 条评价记录。所以当评价大于等于 1500 时 ISV 可以通过 start_date 及 end_date 来进行拆分,以保证可以查询到全部数据
has_next Boolean true 当使用 use_has_next 时返回信息,如果还有下一页则返回 true
withholding_money int 12 该接口扣费金额(点券)

返回数据

{
           "code": 0,
           "msg": "成功",
           "msec": 1193,
           "time": 1612416107,
           "data": {
					 "withholding_money": 1,
           "tid":1234,
           "oid":1234,
           "role":"seller",
           "nick":"张三",
           "result":"good(好评)",
           "created":"2010-01-01 13:30:05",
           "rated_nick":"李四",
           "item_title":"cdma冲值卡",
           "item_price":"200.07",
           "content":"很快、很好",
           "reply":"谢谢",
           "num_iid":1500006394531,
           "valid_score":true
           }   
     
}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权
401 身份凭证无效 在请求头中添加 access_token,重新更新 token
404 请求路径或请求方式错误 请更换请求方式或者检查路径是否正确
614 用户未登录或者非法的用户昵称 使用正确的用户昵称登录
614 评价者角色非法;买家身份不能查询评价 使用合法的评价者角色
614 评价类型非法 使用合法的评价类型
614 评价结果非法 使用合法的评价结果
614 使用了非法参数 tid 使用合法的交易父订单号
614 参数校验错误 根据返回的错误内容得到具体细节
614 订单不存在 使用正确的订单查询评价信息