微信接口分析數(shù)據(jù)接口

2019-03-14 12:09 更新

接口分析數(shù)據(jù)接口

接口分析數(shù)據(jù)


微信公眾平臺于2015年1月6日啟動了數(shù)據(jù)接口的邀請內(nèi)測。通過數(shù)據(jù)接口,開發(fā)者可以獲取與公眾平臺官網(wǎng)統(tǒng)計模塊類似但更靈活的數(shù)據(jù),還可根據(jù)需要進行高級處理。

在公眾號登錄授權(quán)機制的權(quán)限集劃分中,接口分析數(shù)據(jù)接口屬于帳號服務(wù)權(quán)限。

向所有公眾號開發(fā)者開放數(shù)據(jù)接口的時間將另行通知。

請注意:

1、接口側(cè)的公眾號數(shù)據(jù)的數(shù)據(jù)庫中僅存儲了2014年12月1日之后的數(shù)據(jù),將查詢不到在此之前的日期,即使有查到,也是不可信的臟數(shù)據(jù);
2、請開發(fā)者在調(diào)用接口獲取數(shù)據(jù)后,將數(shù)據(jù)保存在自身數(shù)據(jù)庫中,即加快下次用戶的訪問速度,也降低了微信側(cè)接口調(diào)用的不必要損耗。

接口分析數(shù)據(jù)接口指的是用于獲得公眾平臺官網(wǎng)數(shù)據(jù)統(tǒng)計模塊中接口分析數(shù)據(jù)的接口,具體接口列表如無用戶屬性數(shù)據(jù)接口):

接口名稱最大時間跨度接口調(diào)用地址(必須使用https)
獲取接口分析數(shù)據(jù)(getinterfacesummary)30https://api.weixin.qq.com/datacube/getinterfacesummary?access_token=ACCESS_TOKEN
獲取接口分析分時數(shù)據(jù)(getinterfacesummaryhour)1https://api.weixin.qq.com/datacube/getinterfacesummaryhour?access_token=ACCESS_TOKEN

最大時間跨度是指一次接口調(diào)用時最大可獲取數(shù)據(jù)的時間范圍,如最大時間跨度為7是指最多一次性獲取7天的數(shù)據(jù)。access_token的實際值請通過“獲取access_token”來獲取。


接口調(diào)用請求說明

接口分析數(shù)據(jù)接口(包括接口列表中的所有接口)需要向相應(yīng)接口調(diào)用地址POST以下示例數(shù)據(jù)包:

{ 
    "begin_date": "2014-12-07", 
    "end_date": "2014-12-07"
}

調(diào)用參數(shù)說明

參數(shù)是否必須說明
access_token調(diào)用接口憑證
begin_date獲取數(shù)據(jù)的起始日期,begin_date和end_date的差值需小于“最大時間跨度”(比如最大時間跨度為1時,begin_date和end_date的差值只能為0,才能小于1),否則會報錯
end_date獲取數(shù)據(jù)的結(jié)束日期,end_date允許設(shè)置的最大值為昨日

返回說明

正常情況下,獲取接口分析數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下:

{ 
   "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之間)的數(shù)據(jù)
   ]
}

正常情況下,獲取接口分析分時數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下:

{ 
   "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的數(shù)據(jù)
   ]
}

返回參數(shù)說明

參數(shù)說明
ref_date數(shù)據(jù)的日期
ref_hour數(shù)據(jù)的小時
callback_count通過服務(wù)器配置地址獲得消息后,被動回復(fù)用戶消息的次數(shù)
fail_count上述動作的失敗次數(shù)
total_time_cost總耗時,除以callback_count即為平均耗時
max_time_cost最大耗時

錯誤時微信會返回錯誤碼等信息,具體錯誤碼查詢,請見:全局返回碼說明

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號