# 获取小程序性能数据
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
getPerformanceData
# 功能描述
该接口用于获取小程序启动性能,运行性能等数据
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/business/performance/boot?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:18、21
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用getAccessToken 或者 authorizer_access_token | ||||||||||||||||
module | number | 是 | 查询数据的类型 | ||||||||||||||||
time | object | 是 | 开始和结束日期的时间戳,时间跨度不能超过30天 | ||||||||||||||||
| |||||||||||||||||||
params | array<object> | 是 | 查询条件,比如机型,网络类型等等 | ||||||||||||||||
|
# 返回参数
属性 | 类型 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errcode | number | 错误码 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
errmsg | string | 错误信息 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data | object | 返回的性能数据 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
# 其他说明
# module 的合法值
值 | 说明 |
---|---|
10016 | 打开率, params字段可传入网络类型和机型 |
10017 | 启动各阶段耗时,params字段可传入网络类型和机型 |
10021 | 页面切换耗时,params数组字段可传入机型 |
10022 | 内存指标,params数组字段可传入机型 |
10023 | 内存异常,params数组字段可传入机型 |
# field 的合法值
值 | 说明 |
---|---|
networktype | 网络类型作为查询条件,value=“-1,3g,4g,wifi”分别表示 全部网络类型,3G,4G,WIFI,不传networktype默认为全部网络类型 |
device_level | 机型作为查询条件,此时value=“-1,1,2,3”分别表示 全部机型,高档机,中档机,低档机,不传device_level默认为全部机型 |
device | 平台作为查询条件,此时value="-1,1,2"分别表示 全部平台,IOS平台,安卓平台,不传device默认为全部平台 |
# 调用示例
示例说明: HTTPS调用
# 请求数据示例
{
"time": {
"end_timestamp": 1609689600,
"begin_timestamp": 1609603200
},
"module": "10022",
"params": [{
"field": "networktype",
"value": "wifi"
}, {
"field": "device_level",
"value": "1"
}, {
"field": "device",
"value": "1"
}]
}
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"data": {
"body": {
"tables": [
{
"id": "memorydiff",
"lines": [
{
"fields": [
{
"refdate": "20210103",
"value": "70.7778"
},
{
"refdate": "20210104",
"value": "72.0446"
}
]
}
],
"zh": "内存增长均值"
},
{
"id": "memory",
"lines": [
{
"fields": [
{
"refdate": "20210103",
"value": "314"
},
{
"refdate": "20210104",
"value": "302.3218"
}
]
}
],
"zh": "内存均值"
}
],
"count": 2
}
}
}
示例说明: 云函数调用
# 请求数据示例
const cloud = require('wx-server-sdk')
cloud.init({
env: cloud.DYNAMIC_CURRENT_ENV,
})
exports.main = async (event, context) => {
try {
const result = await cloud.openapi.analysis.getPerformanceData({
"time": {
"endTimestamp": 1609689600,
"beginTimestamp": 1609603200
},
"module": '10022',
"params": [
{
"field": 'networktype',
"value": 'wifi'
},
{
"field": 'device_level',
"value": '1'
},
{
"field": 'device',
"value": '1'
}
]
})
return result
} catch (err) {
return err
}
}
# 返回数据示例
{
"errCode": 0,
"errMsg": "openapi.analysis.getPerformanceData:ok",
"data": {
"body": {
"tables": [
{
"id": "memorydiff",
"lines": [
{
"fields": [
{
"refdate": "20210103",
"value": "70.7778"
},
{
"refdate": "20210104",
"value": "72.0446"
}
]
}
],
"zh": "内存增长均值"
},
{
"id": "memory",
"lines": [
{
"fields": [
{
"refdate": "20210103",
"value": "314"
},
{
"refdate": "20210104",
"value": "302.3218"
}
]
}
],
"zh": "内存均值"
}
],
"count": 2
}
}
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |