建站
咨詢
售后
建站咨詢
新聞中心
微信公眾平臺(tái)于2015年1月6日啟動(dòng)了數(shù)據(jù)接口的邀請(qǐng)內(nèi)測(cè)。通過數(shù)據(jù)接口，開發(fā)者可以獲取與公眾平臺(tái)官網(wǎng)統(tǒng)計(jì)模塊類似但更靈活的數(shù)據(jù)，還可根據(jù)需要進(jìn)行高級(jí)處理。
邀請(qǐng)內(nèi)測(cè)期間，為保證服務(wù)質(zhì)量，數(shù)據(jù)接口僅向第三方平臺(tái)開發(fā)者開放。在微信開放平臺(tái)接入公眾號(hào)登錄授權(quán)即可成為第三方平臺(tái)開發(fā)者，第三方平 臺(tái)可幫助運(yùn)營者管理公眾號(hào)，幫助已授權(quán)公眾號(hào)調(diào)用數(shù)據(jù)接口。在公眾號(hào)登錄授權(quán)機(jī)制的權(quán)限集劃分中，接口分析數(shù)據(jù)接口屬于帳號(hào)管理權(quán)限集。
向所有公眾號(hào)開發(fā)者開放數(shù)據(jù)接口的時(shí)間將另行通知。
請(qǐng)注意：
1、接口側(cè)的公眾號(hào)數(shù)據(jù)的數(shù)據(jù)庫中僅存儲(chǔ)了2014年12月1日之后的數(shù)據(jù)，將查詢不到在此之前的日期，即使有查到，也是不可信的臟數(shù)據(jù)； 2、請(qǐng)開發(fā)者在調(diào)用接口獲取數(shù)據(jù)后，將數(shù)據(jù)保存在自身數(shù)據(jù)庫中，即加快下次用戶的訪問速度，也降低了微信側(cè)接口調(diào)用的不必要損耗。
接口分析數(shù)據(jù)接口指的是用于獲得公眾平臺(tái)官網(wǎng)數(shù)據(jù)統(tǒng)計(jì)模塊中接口分析數(shù)據(jù)的接口，具體接口列表如無用戶屬性數(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)通過“獲取access_token”來獲取。
接口調(diào)用請(qǐng)求說明
接口分析數(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的差值需小于“***時(shí)間跨度”（比如***時(shí)間跨度為1時(shí)，begin_date和end_date的差值只能為0，才能小于1），否則會(huì)報(bào)錯(cuò) |
| 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í)數(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ù)的小時(shí) |
| callback_count | 通過服務(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)見：全局返回碼說明
當(dāng)前名稱：數(shù)據(jù)統(tǒng)計(jì)接口-接口分析數(shù)據(jù)接口
轉(zhuǎn)載來源：http://www.5511xx.com/article/cohphsj.html
