V兔API开放平台

名称	类型	必须	示例值	描述
shop_id	Number	true	123	店铺 id
fields	String[]	true	tid,oid,role,nick,result,created,rated_nick,item_title,item_price,content,reply,num_iid	需返回的字段列表。可选值：TradeRate 结构中的所有字段，多个字段之间用“,”分隔
rate_type	String	true	get	评价类型。可选值：get(得到),give(给出)
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
ouid	String	false	ALKJDF	ouid
vvtype	Number	false	false	2 高级版（必须填 2,不填默认是 2）

请求示例

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

名称	类型	示例值	描述
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 个汉字
num_iid	Number	1500006394531	商品的数字 ID
logistics_service_score	Number	4	物流服务评分
ouid	String	ALKJFD	ouid
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	11	该接口扣费金额（点券）

返回数据

{
	"code": 0,
	"msg": "操作成功",
	"msec": 1469,
	"time": 1617270403,
	"data": {
		"withholding_money": 1,
		"traderates_get_response":{
        "trade_rates":{
            "results":[
                {
                    "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,
                    "logistics_service_score":4,
                    "ouid":"ALKJFD",
                    "valid_score":true
                }
            ]
        },
        "total_results":50,
        "has_next":true
    }
		}
	}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权
614	没有可访问的店铺	该接口是商家使用接口，非商家店铺不能查询、访问。

搜索评价信息

请求头参数

请使用新的生成 token 接口 点击查看详情

请求参数

请求示例

请求代码示例

响应参数

返回数据

响应代码

请使用新的生成 token 接口点击查看详情