接口調用頻率規范
概念介紹
小程序wx接口可分為“普通接口”和“限頻接口”。
“限頻接口”指的是一個用戶在一段時間內不允許頻繁調用的wx接口，此類接口一般會調用到微信后臺系統資源，為了保護系統，同時防止用戶資源被濫用，開發者需要對此類接口做適度的頻率限制，不能無節制地調用。
平臺會對小程序內“限頻接口”的調用情況做監控，如果小程序對此類接口的調用頻率超出平臺的規范，將會收到站內信提醒。系統會在資源緊張的情況下優先保障合理使用的小程序的服務。
開發者可登錄小程序管理后臺-開發管理-接口設置中查看“限頻接口”調用情況。
目前，“限頻接口”包括以下接口：
頻率規范
| API | 規范 | 其他說明 |
|---|---|---|
| wx.login | 一天的調用總次數不多于該小程序pv的兩倍,單用戶一秒鐘不能大于4次 | - |
| wx.checkSession | 一天的調用總次數不多于該小程序pv的兩倍,單用戶一秒鐘不能大于4次 | - |
| wx.getSetting | 一天的調用總次數不多于該小程序pv的兩倍,單用戶一秒鐘不能大于4次 | - |
| wx.getUserInfo | 一天的調用總次數不多于該小程序pv的兩倍,單用戶一秒鐘不能大于4次 | - |
| wx.getUserProfile | 一天的調用總次數不多于該小程序pv的兩倍,單用戶一秒鐘不能大于4次 | - |
Tips: 微信后臺會延遲一天統計上一天的小程序pv總數和api調用總數，超過規范總數的會提醒盡快調整。
優化方法
開發者可以參考以下方法對“限頻接口”的調用頻率做優化：
- 把上一次調用接口的返回結果緩存下來以供后續邏輯復用，而不是重新調用接口
- 避免在定時循環的邏輯內重復調用“限頻接口”
- 避免在頁面初始化事件
onLoad、onShow、onReady中調用限頻接口，應該在小程序初始化事件onLaunch中調用
以下是錯誤用法和正確用法示例：
- wx.getSetting 錯誤用法:
setInterval(() => {
wx.getSetting()
}, 5000)
- wx.getSetting 正確用法:
let setting
wx.getSetting({
success(res) {
setting = res
}
})
// 在需要獲取地理位置時
if (setting.authSetting['scope.userLocation']) {
wx.getLocation({
success(res) {},
fail(res) {
if (res.errMsg.indexOf('auth deny') >= 0) {
// 如果權限沒有開，引導用戶打開設置頁開啟地理位置授權
}
}
})
}
- wx.getUserInfo 錯誤用法:
Page({
onShow() {
wx.getUserInfo()
}
})
- wx.getUserInfo 正確用法:
App({
onLaunch() {
wx.getUserInfo()
}
})需要在小程序后臺開發管理-接口設置里面全部開通就好了
