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

微信公眾平臺(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ù)接口屬于消息管理權(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ú)消息關(guān)鍵詞數(shù)據(jù)接口）：

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

關(guān)于周數(shù)據(jù)與月數(shù)據(jù)，請(qǐng)注意：每個(gè)月/周的周期數(shù)據(jù)的數(shù)據(jù)標(biāo)注日期在當(dāng)月/當(dāng)周的第一天（當(dāng)月1日或周一）。在某一月/周過(guò)后去調(diào)用接口，才能獲取到該周期的數(shù)據(jù)。比如，在12月1日以（11月1日-11月5日）作為（begin_date和end_date）調(diào)用獲取月數(shù)據(jù)接口，可以獲取到11月1日的月數(shù)據(jù)（即11月的月數(shù)據(jù)）。

接口調(diào)用請(qǐng)求說(shuō)明

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

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

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

返回說(shuō)明

獲取消息發(fā)送概況數(shù)據(jù)接口需要向相應(yīng)接口調(diào)用地址POST以下數(shù)據(jù)包：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "msg_type": 1, 
           "msg_user": 282, 
           "msg_count": 817
       }
	//后續(xù)還有同一ref_date的不同msg_type的數(shù)據(jù)，以及不同ref_date（在時(shí)間范圍內(nèi)）的數(shù)據(jù)
   ]
}

獲取消息分送分時(shí)數(shù)據(jù)接口需要向相應(yīng)接口調(diào)用地址POST以下數(shù)據(jù)包：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "ref_hour": 0, 
           "msg_type": 1, 
           "msg_user": 9, 
           "msg_count": 10
       }
	//后續(xù)還有同一ref_hour的不同msg_type的數(shù)據(jù)，以及不同ref_hour的數(shù)據(jù)，ref_date固定，因?yàn)樽畲髸r(shí)間跨度為1
   ]
}

獲取消息發(fā)送周數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-08", 
           "msg_type": 1, 
           "msg_user": 16, 
           "msg_count": 27
       }
		//后續(xù)還有同一ref_date下不同msg_type的數(shù)據(jù)，及不同ref_date的數(shù)據(jù)
   ]
}

獲取消息發(fā)送月數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-11-01", 
           "msg_type": 1, 
           "msg_user": 7989, 
           "msg_count": 42206
       }
	//后續(xù)還有同一ref_date下不同msg_type的數(shù)據(jù)，及不同ref_date的數(shù)據(jù)
   ]
}

獲取消息發(fā)送分布數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后續(xù)還有同一ref_date下不同count_interval的數(shù)據(jù)，及不同ref_date的數(shù)據(jù)
   ]
}

獲取消息發(fā)送分布周數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后續(xù)還有同一ref_date下不同count_interval的數(shù)據(jù)，及不同ref_date的數(shù)據(jù)
   ]
}

獲取消息發(fā)送分布月數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后續(xù)還有同一ref_date下不同count_interval的數(shù)據(jù)，及不同ref_date的數(shù)據(jù)
   ]
}

返回參數(shù)說(shuō)明

錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，具體錯(cuò)誤碼查詢，請(qǐng)見：全局返回碼說(shuō)明