详细描述

获取某个订单的评价数据

支持平台: 淘宝

API用户类型授权

需授权

系统级别输入参数

名称 类型 是否必须 描述
method String

API接口名称

certi_id Number

分配给应用的证书ID

from_node_id String

API调用的来源节点ID,对于第三方开发者来说,此id即为申请应用颁发的APP KEY

from_api_v String

请求方版本号

to_node_id String

API调用的目的节点ID(除了基础服务类api,其他接口必传此参数)

to_api_v String

接收方版本号

callback_url String

响应回调地址,带http路径的标准URL。(调用异步接口此参数必填)

v String

矩阵API协议版本,可选值:1.0

timestamp String

时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2008-01-25 20:23:30。ShopEx API服务端允许客户端请求时间误差为10分钟

format String

可选,指定响应格式。默认JSON ,目前支持格式为JSON

sign String

对调用API时所有输入参数(包括应用级参数)进行签名结果

应用级输入参数

名称 类型
默认全部
示例值 默认值 描述
tid String

淘宝(可选)

1231231

交易编号(交易订单号)

oid String

淘宝(可选)

123131313

子订单号

start_time Date

淘宝(可选)

2011-05-03 10:34:15

评价开始时间 yyyy-MM-dd HH:mm:ss

end_time Date

淘宝(可选)

2011-05-05 11:32:10

评价结束时间 yyyy-MM-dd HH:mm:ss

page_no Number

淘宝(可选)

1

页码。取值范围:大于零的整数;

page_size Number

淘宝(可选)

40

每页获取条数。默认值40,最小值1,最大值150。相同的查询时间段条件下,最大只能获取总共1500条评价记录。

result Number

淘宝(可选)

1

评价结果。可选值:3(好评),2(中评),1(差评)

rate_type String

淘宝(可选)

get

get

评价类型。可选值:get(得到),give(给出)

role String

淘宝(可选)

seller

seller

评价者角色即评价的发起方。可选值:seller(卖家),buyer(买家)当 give buyer 以买家身份给卖家的评价; 当 get seller 以买家身份得到卖家给的评价; 当 give seller 以卖家身份给买家的评价; 当 get buyer 以卖家身份得到买家给的评价。

返回结果

名称 类型 是否必须 示例值 描述
traderate TradeRate

评价数据

total_results Number

1

具体返回条数

XML数据格式:

			
JSON数据格式:
{
	"rsp": "succ",
	"msg_id": "3463421b2581604c74dcb9b74ffab2e4",
	"data": {
              "trade_rate": [{
	    "content": "好评!",
	    "created": "2010-05-20 22:00:37",
	    "item_price": "1.2",
	    "item_title": "【24小时自动电脑充值】海南移动快充1元67.la#AAA",
	    "nick": "easesou",
	    "oid":"37750250222274",
             "rated_nick": "匿名",
	    "result": "good",              
             "role": "seller",
	    "tid": "37750250222274"
	    }]
            "total_results": 1
           }
}

错误码

错误码 错误描述 解决方案

FAQ

修改时间:2012-05-09 11:42:39