taobao.traderates.get (搜索评价信息)

搜索评价信息,只能获取距今180天内的评价记录(只支持查询卖家给出或得到的评价)。

公共参数

请求参数

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

    响应参数

    名称 类型 示例值 描述
    total_results Number 50 搜索到的评价总数。相同的查询时间段条件下,最大只能获取总共1500条评价记录。所以当评价大于等于1500时 ISV可以通过start_date及end_date来进行拆分,以保证可以查询到全部数据
    has_next Boolean true 当使用use_has_next时返回信息,如果还有下一页则返回true
    trade_rates Results [] {} 评价列表。返回的TradeRate包含的具体信息为入参fields请求的字段信息
    • └ 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
    • String
    • 200.07
    • 商品价格,精确到2位小数;单位:元.如:200.07,表示:200元7分
    • └ content
    • String
    • 很快、很好
    • 评价内容,最大长度:500个汉字
    • └ reply
    • String
    • 谢谢
    • 评价解释,最大长度:500个汉字
    • └ valid_score
    • Boolean
    • true
    • 评价信息是否用于记分, 可取值:true(参与记分)和false(不参与记分)
    • └ num_iid
    • Number
    • 1500006394531
    • 商品的数字ID
    • └ logistics_service_score
    • Number
    • 4
    • 物流服务评分
    • └ ouid
    • String
    • ALKJFD
    • ouid

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TraderatesGetRequest req = new TraderatesGetRequest();
    req.setFields("tid,oid,role,nick,result,created,rated_nick,item_title,item_price,content,reply,num_iid");
    req.setRateType("get");
    req.setRole("seller");
    req.setResult("good");
    req.setPageNo(1L);
    req.setPageSize(100L);
    req.setPeerNick("helloworld");
    req.setStartDate(StringUtils.parseDateTime("2011-01-01 00:00:00"));
    req.setEndDate(StringUtils.parseDateTime("2011-01-02 00:00:00"));
    req.setTid(123456L);
    req.setUseHasNext(true);
    req.setNumIid(1234L);
    req.setOuid("ALKJDF");
    TraderatesGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <traderates_get_response>
        <total_results>50</total_results>
        <has_next>true</has_next>
        <trade_rates>
            <results>
                <tid>1234</tid>
                <oid>1234</oid>
                <role>seller</role>
                <nick>张三</nick>
                <result>good</result>
                <created>2010-01-01 13:30:05</created>
                <rated_nick>李四</rated_nick>
                <item_title>cdma冲值卡</item_title>
                <item_price>200.07</item_price>
                <content>很快、很好</content>
                <reply>谢谢</reply>
                <valid_score>true</valid_score>
                <num_iid>1500006394531</num_iid>
                <logistics_service_score>4</logistics_service_score>
                <ouid>ALKJFD</ouid>
            </results>
        </trade_rates>
    </traderates_get_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.user-not-exist:invalid-nick 用户未登录或者非法的用户昵称 使用正确的用户昵称登录
    isv.invalid-parameter:role 评价者角色非法;买家身份不能查询评价 使用合法的评价者角色
    isv.invalid-parameter:rate_type 评价类型非法 使用合法的评价类型
    isv.invalid-parameter:result 评价结果非法 使用合法的评价结果
    isv.invalid-parameter:tid 使用了非法参数tid 使用合法的交易父订单号
    isv.rate-service-error 参数校验错误 根据返回的错误内容得到具体细节
    isv.trade-not-exist 订单不存在 使用正确的订单查询评价信息

    API工具

    如何获得此API

    FAQ

    返回
    顶部