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