tt.rateAwemeOrder

我的收藏

基础库 2.26.0 开始支持本方法。

根据传入的订单 id，跳转到抖音评价页面，供用户填写评价。待评价订单中的商品必须在 POI 商品库中，非商品库中的商品订单暂不支持该能力。

该 API 只支持抖音宿主。

语法

tt.rateAwemeOrder(options);

参数说明

object 类型，属性如下：

属性名	类型	必填	说明	最低支持版本
orderId	string	是	需要评价的订单 id（开发者自己的订单 id）	2.26.0
success	function	否	接口调用成功的回调函数	2.26.0
fail	function	否	接口调用失败的回调函数	2.26.0
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）	2.26.0

回调成功

object 类型，属性如下：

属性名	类型	说明	最低支持版本
result	boolean	`true` 表示用户已经评价了（用户写完评价回到小程序），`false` 表示用户未评价（用户直接返回小程序）	2.26.0
errMsg	string	"rateAwemeOrder:ok"	2.26.0

回调失败

object 类型，属性如下：

属性	类型	说明	最低支持版本
errNo	number	错误码	2.26.0
errMsg	string	"rateAwemeOrder:fail " + 详细错误信息	2.26.0

错误码说明

errNo	errMsg	说明	最低支持版本
10301	rateAwemeOrder:fail feature is not supported in app	宿主不支持	2.26.0
10601	rateAwemeOrder:fail not login	没有登陆	2.26.0
20001	rateAwemeOrder:fail param should be xxx, but got xxx	参数错误	2.26.0
21102	rateAwemeOrder:fail canRateAwemeOrders should be called first	没有提前调用 canRateAwemeOrders，导致没有 schema	2.26.0
21103	rateAwemeOrder:fail schema not found	找不到订单对应的 schema，订单无法评价	2.26.0
21104	rateAwemeOrder:fail permission denied	开发者无权限	2.26.0

代码示例

开发者工具中预览

tt.rateAwemeOrder({
  orderId: "123",
  success({ result }) {
    if (result) {
      // 用户已经评价的逻辑
    } else {
      // 用户没有评价的逻辑
    }
  },
  fail(err) {},
});

Bug & Tip

Tip：必须先调用 tt.canRateAwemeOrders 才能调用该 API。

下一篇：小程序文档指引