taobao.traderate.list.add (针对父子订单新增批量评价)

针对父子订单新增批量评价(注:在评价之前需要对订单成功的时间进行判定(end_time),如果超过15天,不用再通过该接口进行评价)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid Number 必须 1234 交易ID
result String 必须 bad 评价结果。可选值:good(好评),neutral(中评),bad(差评)
role String 必须 buyer 评价者角色。可选值:seller(卖家),buyer(买家)
content String 可选 很烂 评价内容,最大长度: 500个汉字 .注意:当评价结果为good时就不用输入评价内容.评价内容为neutral/bad的时候需要输入评价内容
anony Boolean 可选 true 是否匿名,卖家评不能匿名。可选值:true(匿名),false(非匿名)。 注意:如果买家匿名购买,那么买家的评价默认匿名

响应参数

名称 类型 示例值 描述
trade_rate TradeRateRequest 返回的评论的信息,仅返回tid和created字段
  • └ tid
  • Number
  • 1234
  • 交易ID
  • └ created
  • Date
  • 2010-01-01 13:30:05
  • 评价创建时间,格式:yyyy-MM-dd HH:mm:ss

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TraderateListAddRequest req = new TraderateListAddRequest();
req.setTid(1234L);
req.setResult("bad");
req.setRole("buyer");
req.setContent("很烂");
req.setAnony(true);
TraderateListAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<traderate_list_add_response>
    <trade_rate>
        <tid>1234</tid>
        <created>2010-01-01 13:30:05</created>
    </trade_rate>
</traderate_list_add_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter:tid 参数:tid无效,格式不对、非法值、越界等
isv.tc-service-error:0 参数错误或评价已过有效期 1,评价内容包含非法字符(网址,JS脚本,关键词等) 2,评价已过期,这种情况下加一个15天的有效期限制,也就是只对交易成功之后15天以内未评价的订单进行评价
isv.tc-service-error:-1020 已评价或已过评价有效期 加一个15天的有效期限制,也就是只对交易成功之后15天以内未评价的订单进行评价
isv.tc-service-error:-930 不能对商城订单进行评价 前端注名这个规则或者评价前用taobao.user.get这个接口获取用户类型,如果是B商家则不予以评价
isv.rate-service-error:-923 用户与交易不一致 调用之前请对SessionKey所绑定的用户和交易所属的用户进行匹配,只能一致的情况下才能进行调用
isv.rate-service-error:0 参数不合法,可能情况为:参数错误、父订单为空、评价者角色非法、非法的匿名方式、卖家不可以匿名评价、评价内容不能超过500个汉字、评价内容包含非法字符(JS、URL或禁用词)、评价结果非法、IP地址非法 请根据接口返回的errorMessage进行处理
isv.rate-service-error:-1020 已评价或已过评价有效期 加一个15天的有效期限制,也就是只对交易成功之后15天以内未评价的订单进行评价。具体的业务是:在交易成功后的15天内进行评价,若在评价期间内未进行评价操作,则无评价操作入口,如一方好评而另一方未评,在交易成功15天以后系统将自动默认给予评价方好评。 如一方在评价期间内作出“中评”或“差评”,另一方在评价期间内未评的,则系统不给评价方默认评价,一方评价之后30天内可修改评价。 目前评价只针对于卖家对买家的评价。如果买家对卖家进行评价的话还需要对店铺动态评分,这个时候调用评价接口会返回成功但是淘宝后台该订单还是未评价状态,所以会导致再次取出来重复评价的错误。
isv.rate-service-error:-930 不能对商城订单和无名良品订单进行评价 前端注名这个规则或者评价前用taobao.user.get这个接口获取用户类型,如果是B商家或者返回的liangpin参数为true,则不予以评价
isv.rate-service-error 参数不合法,可能情况为:参数错误、父订单为空、评价者角色非法、非法的匿名方式、卖家不可以匿名评价、评价内容不能超过500个汉字、评价内容包含非法字符(JS、URL或禁用词)、评价结果非法、IP地址非法,没在评价有效期 请根据接口返回的errorMessage进行处理
isv.rate-service-error:bussiness 评价业务逻辑错误,可能有使用商城卖家或新农业卖家进行评价 不能对商城卖家或者新农业卖家使用
isv.user-not-exist:invalid-nick 用户昵称不合法或者不是正确的交易方 使用正确的用户昵称
isv.rate-service-error:tradeorder 没有可以评价的订单 该父订单下面的所有子订单都已经评价或者不可评价
"isv.rate-service-error","sub_msg":"主订 单不可以评价! info: null" 主订单不可评价,检查订单是否超过15天、已被评价等 。

API工具

如何获得此API

FAQ

返回
顶部