taobao.traderate.add (新增单个评价)

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

公共参数

请求参数

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

响应参数

名称 类型 示例值 描述
trade_rate TradeRateRequest 返回tid、oid、create
  • └ tid
  • Number
  • 1234
  • 交易ID
  • └ oid
  • 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);
TraderateAddRequest req = new TraderateAddRequest();
req.setTid(1234L);
req.setOid(1234L);
req.setResult("neutral");
req.setRole("seller");
req.setContent("很好,很快");
req.setAnony(true);
TraderateAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<traderate_add_response>
    <trade_rate>
        <tid>1234</tid>
        <oid>1234</oid>
        <created>2010-01-01 13:30:05</created>
    </trade_rate>
</traderate_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.rate-service-error:-928 不能对父子订单中的父订单进行评价 通过获取交易信息接口判断订单是父订单还是子订单之后再进行评价,判断的方法是tid=oid则对tid进行评价即可,tid!=oid则对oid进行评价
isv.tc-service-error:-930 不能对商城订单和无名良品订单进行评价 前端注名这个规则或者评价前用taobao.user.get这个接口获取用户类型,如果是B商家或者返回的liangpin参数为true,则不予以评价
isv.rate-service-error:-1020 已评价或已过评价有效期 通过Order中的buyer_rate和seller_rate来决定是否需要对订单进行评价;通过Trade中的end_time来判断评价时间是否已经超过15天期限
isv.rate-service-error:-931 交易订单不存在 评价之前请通过交易的创建时间进行简单的判断,如果是3个月前创建的订单,不需要对其进行评价了
isv.rate-service-error:-929 父订单号不正确 在调用评价接口前需要确保oid是属于tid的一个子订单
isv.rate-service-error:0 参数不合法,可能情况为:参数错误、父订单为空、评价者角色非法、非法的匿名方式、卖家不可以匿名评价、评价内容不能超过500个汉字、评价内容包含非法字符(JS、URL或禁用词)、评价结果非法、IP地址非法 请根据接口返回的errorMessage进行处理
isv.rate-service-error 不能对父子订单中的父订单进行评价 通过获取交易信息接口判断订单是父订单还是子订单之后再进行评价,判断的方法是tid=oid则对tid进行评价即可,tid!=oid则对oid进行评价
isv.rate-service-error:bussiness 评价业务错误 前端注名这个规则或者评价前用taobao.user.get这个接口获取用户类型,如果是B商家或者返回的liangpin参数为true,则不予以评价
isv.rate-service-error:tradeorder 交易订单不存在 评价之前请通过交易的创建时间进行简单的判断,如果是3个月前创建的订单,不需要对其进行评价了
isv.user-not-exist:invalid-nick 用户昵称不合法 不存在的用户昵称或者用户昵称不合法
isv.invalid-parameter:role 评价的角色错误 当前登录用户不是交易中用户
isv.invalid-parameter:tid tid错误 传入的tid有问题,tid为空 或者tid不是oid的父订单
isp.call-limited
isp.service-unavailable

API工具

如何获得此API

FAQ

返回
顶部