W3Cschool
恭喜您成為首批注冊用戶
獲得88經驗值獎勵
微信公眾平臺于2015年1月6日啟動了數據接口的邀請內測。通過數據接口,開發(fā)者可以獲取與公眾平臺官網統(tǒng)計模塊類似但更靈活的數據,還可根據需要進行高級處理。
在公眾號登錄授權機制的權限集劃分中,接口分析數據接口屬于帳號服務權限。
向所有公眾號開發(fā)者開放數據接口的時間將另行通知。
請注意:
1、接口側的公眾號數據的數據庫中僅存儲了2014年12月1日之后的數據,將查詢不到在此之前的日期,即使有查到,也是不可信的臟數據; 2、請開發(fā)者在調用接口獲取數據后,將數據保存在自身數據庫中,即加快下次用戶的訪問速度,也降低了微信側接口調用的不必要損耗。
接口分析數據接口指的是用于獲得公眾平臺官網數據統(tǒng)計模塊中接口分析數據的接口,具體接口列表如無用戶屬性數據接口):
接口名稱 | 最大時間跨度 | 接口調用地址(必須使用https) |
---|---|---|
獲取接口分析數據(getinterfacesummary) | 30 | https://api.weixin.qq.com/datacube/getinterfacesummary?access_token=ACCESS_TOKEN |
獲取接口分析分時數據(getinterfacesummaryhour) | 1 | https://api.weixin.qq.com/datacube/getinterfacesummaryhour?access_token=ACCESS_TOKEN |
最大時間跨度是指一次接口調用時最大可獲取數據的時間范圍,如最大時間跨度為7是指最多一次性獲取7天的數據。access_token的實際值請通過“獲取access_token”來獲取。
接口調用請求說明
接口分析數據接口(包括接口列表中的所有接口)需要向相應接口調用地址POST以下示例數據包:
{ "begin_date": "2014-12-07", "end_date": "2014-12-07" }
調用參數說明
參數 | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調用接口憑證 |
begin_date | 是 | 獲取數據的起始日期,begin_date和end_date的差值需小于“最大時間跨度”(比如最大時間跨度為1時,begin_date和end_date的差值只能為0,才能小于1),否則會報錯 |
end_date | 是 | 獲取數據的結束日期,end_date允許設置的最大值為昨日 |
返回說明
正常情況下,獲取接口分析數據接口的返回JSON數據包如下:
{ "list": [ { "ref_date": "2014-12-07", "callback_count": 36974, "fail_count": 67, "total_time_cost": 14994291, "max_time_cost": 5044 } //后續(xù)還有不同ref_date(在begin_date和end_date之間)的數據 ] }
正常情況下,獲取接口分析分時數據接口的返回JSON數據包如下:
{ "list": [ { "ref_date": "2014-12-01", "ref_hour": 0, "callback_count": 331, "fail_count": 18, "total_time_cost": 167870, "max_time_cost": 5042 } //后續(xù)還有不同ref_hour的數據 ] }
返回參數說明
參數 | 說明 |
---|---|
ref_date | 數據的日期 |
ref_hour | 數據的小時 |
callback_count | 通過服務器配置地址獲得消息后,被動回復用戶消息的次數 |
fail_count | 上述動作的失敗次數 |
total_time_cost | 總耗時,除以callback_count即為平均耗時 |
max_time_cost | 最大耗時 |
錯誤時微信會返回錯誤碼等信息,具體錯誤碼查詢,請見:全局返回碼說明
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯系方式:
更多建議: