微信消息分析數(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ù)接口屬于消息管理權(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ù)的接口，具體接口列表如下（暫無消息關(guān)鍵詞數(shù)據(jù)接口）：

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

關(guān)于周數(shù)據(jù)與月數(shù)據(jù)，請注意：每個月/周的周期數(shù)據(jù)的數(shù)據(jù)標(biāo)注日期在當(dāng)月/當(dāng)周的第一天（當(dāng)月1日或周一）。在某一月/周過后去調(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)用請求說明

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

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

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

返回說明

獲取消息發(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（在時間范圍內(nèi)）的數(shù)據(jù)
   ]
}

獲取消息分送分時數(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固定，因為最大時間跨度為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ù)說明

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