微信公衆平臺開發

微信公衆平臺開發接口介紹

主要介紹幾個用到的接口的使用方法，更多接口介紹

獲取access_token

access_token是公衆號的全局唯一票據，公衆號調用各接口時都需使用access_token。開發者需要進行妥善保存。 access_token的存儲至少要保留512個字符空間。access_token的有效期目前爲2個小時，需定時刷新，重複獲取將導致上次獲取的 access_token失效。
公衆平臺的API調用所需的access_token的使用及生成方式說明：

1、爲了保密appsecrect，第三方需要一個access_token獲取和刷新的中控服務器。而其他業務邏輯服務器所使用的access_token均來自於該中控服務器，不應該各自去刷新，否則會造成access_token覆蓋而影響業務；
2、 目前access_token的有效期通過返回的expire_in來傳達，目前是7200秒之內的值。中控服務器需要根據這個有效時間提前去刷新新 access_token。在刷新過程中，中控服務器對外輸出的依然是老access_token，此時公衆平臺後臺會保證在刷新短時間內，新老 access_token都可用，這保證了第三方業務的平滑過渡；
3、access_token的有效時間可能會在未來有調整，所以中控服務器不 僅需要內部定時主動刷新，還需要提供被動刷新access_token的接口，這樣便於業務服務器在API調用獲知access_token已超時的情況 下，可以觸發access_token的刷新流程。

如果第三方不使用中控服務器，而是選擇各個業務邏輯點各自去刷新access_token，那麼就可能會產生衝突，導致服務不穩定。
公衆號可以使用AppID和AppSecret調用本接口來獲取access_token。AppID和AppSecret可在微信公衆平臺官網-開發者中心頁中獲得（需要已經成爲開發者，且帳號沒有異常狀態）。注意調用所有微信接口時均需使用https協議。

接口調用請求說明

http請求方式: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
參數說明

參數	是否必須	說明
grant_type	是	獲取access_token填寫client_credential
appid	是	第三方用戶唯一憑證
secret	是	第三方用戶唯一憑證密鑰，即appsecret

返回說明

正常情況下，微信會返回下述JSON數據包給公衆號：

{"access_token":"ACCESS_TOKEN","expires_in":7200}

參數	說明
access_token	獲取到的憑證
expires_in	憑證有效時間，單位：秒

錯誤時微信會返回錯誤碼等信息，JSON數據包示例如下（該示例爲AppID無效錯誤）:

{"errcode":40013,"errmsg":"invalid appid"}

獲取用戶列表

公衆號可通過本接口來獲取帳號的關注者列表，關注者列表由一串OpenID（加密後的微信號，每個用戶對每個公衆號的OpenID是唯一的）組成。一次拉取調用最多拉取10000個關注者的OpenID，可以通過多次拉取的方式來滿足需求。

接口調用請求說明

http請求方式: GET（請使用https協議）
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID

參數	是否必須	說明
access_token	是	獲取到的憑證
next_openid	是	第一個拉取的OPENID，不填默認從頭開始拉取

返回說明

正確時返回JSON數據包：

{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}

錯誤時返回JSON數據包（示例爲無效AppID錯誤）：

{"errcode":40013,"errmsg":"invalid appid"}

附：關注者數量超過10000時

當公衆號關注者數量超過10000時，可通過填寫next_openid的值，從而多次拉取列表的方式來滿足需求。

具體而言，就是在調用接口時，將上一次調用得到的返回中的next_openid值，作爲下一次調用中的next_openid值。

示例如下：

公衆賬號A擁有23000個關注的人，想通過拉取關注接口獲取所有關注的人，那麼分別請求url如下：
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN 
返回結果:
{
  "total":23000,
  "count":10000,
  "data":{"
     openid":[
        "OPENID1",
        "OPENID2",
        ...,
        "OPENID10000"
     ]
   },
   "next_openid":"OPENID10000"
}
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1
返回結果:
{
   "total":23000,
   "count":10000,
   "data":{
     "openid":[
       "OPENID10001",
       "OPENID10002",
       ...,
       "OPENID20000"
     ]
   },
   "next_openid":"OPENID20000"
}
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID2
返回結果（關注者列表已返回完時，返回next_openid爲空）:
{
   "total":23000,
   "count":3000,
   "data":{"
       "openid":[
         "OPENID20001",
         "OPENID20002",
         ...,
         "OPENID23000"
       ]
   },
   "next_openid":"OPENID23000"
}