# 获取小程序某个付费能力的最近用量数据
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
getRecentAverageUsage
# 功能描述
小程序可通过本接口查询某个付费能力最近三个月的平均用量;
# 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/wxa/charge/usage/get_recent_average?access_token=ACCESS_TOKEN
# 第三方调用
- 调用方式以及出入参和HTTPS相同,仅是调用的token不同
- 该接口所属的权限集id为:18
- 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。access_token可通过getAccessToken接口获得。 |
spuId | string | 是 | 商品SPU ID |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
averageData | number | 最近月平均用量,经模糊化处理,非精确值 |
注意:当averageData返回值为50时,语义为小程序最近平均用量小于等于50次/月,并不是特指精确等于每月50次。
# 调用示例
示例说明: HTTPS调用
# 请求数据示例
GET https://api.weixin.qq.com/wxa/charge/usage/get_recent_average?access_token={{SP_ACCESS_TOKEN}}&spuId=10000077
# 返回数据示例
{
"errcode": 0,
"averageData": 260000
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
10120002 | 参数错误 | |
10120700 | spuId非法 | |
10122000 | 该商品没有最近使用数据 |