微信開發(fā)筆記

1、1、僅應當收集為運營及功能實現(xiàn)目的而必要的用戶數(shù)據(jù)， 同時應當告知用戶相關(guān)數(shù)據(jù)收集的目的、范圍及使用方式等，保障用戶知情權(quán)。公眾號調(diào)用接口并不是無限制的。為了防止公眾號的程序錯誤而引發(fā)微信服務器負載異常，默認情況下，每個公眾號調(diào)用接口都不能超過一定限制，當超過一定限制時，調(diào)用對應接口會收到如下錯誤返回碼："errcode":45009,"errmsg":"api freq out of limit"開發(fā)者可以登錄微信公眾平臺，在帳號后臺開發(fā)者中心接口權(quán)限模板查看帳號各接口當前的日調(diào)用上限和實時調(diào)用量，對于認證帳號可以對實時調(diào)用量清零，

2、說明如下：1、目前清零功能只對認證帳號開放。2、由于指標計算方法或統(tǒng)計時間差異，實時調(diào)用量數(shù)據(jù)可能會出現(xiàn)誤差，一般在1%以內(nèi)。3、每個帳號每月共10次清零操作機會，清零生效一次即用掉一次機會。4、清零機會可以10次都用在對同一個接口進行清零，也可以用在不同接口上。5、每個有接口調(diào)用限額的接口都可以進行清零操作。6、清零一次后，只有確認清零的接口才會生效，不是清零所有接口。新注冊帳號各接口調(diào)用頻率限制如下：接口 每日限額獲取access_token2000自定義菜單創(chuàng)建 1000自定義菜單查詢 10000自定義菜單刪除 1000創(chuàng)建分組 1000獲取分組 1000修改分組名1000移動用戶分組1

3、00000上傳多媒體文件5000下載多媒體文件10000發(fā)送客服消息500000高級群發(fā)接口100上傳圖文消息接口10刪除圖文消息接口10獲取帶參數(shù)的二維碼100000獲取關(guān)注者列表500獲取用戶基本信息5000000獲取網(wǎng)頁授權(quán)access_token無刷新網(wǎng)頁授權(quán)access_token無網(wǎng)頁授權(quán)獲取用戶信息無設(shè)置用戶備注名10000請注意，在測試號申請頁中申請的測試號，接口調(diào)用頻率限制如下：接口每日限額獲取access_token200自定義菜單創(chuàng)建100自定義菜單查詢1000自定義菜單刪除100創(chuàng)建分組100獲取分組100修改分組名100移動用戶分組1000素材管理-臨時素材上傳500

4、素材管理-臨時素材下載1000發(fā)送客服消息50000獲取帶參數(shù)的二維碼10000獲取關(guān)注者列表100獲取用戶基本信息500000獲取網(wǎng)頁授權(quán)access_token無刷新網(wǎng)頁授權(quán)access_token無網(wǎng)頁授權(quán)獲取用戶信息無不同的公眾號類型具備不同的接口權(quán)限，具體如下表：請注意：1、微博認證視作未認證,因此微博認證的公眾號不會擁有微信認證公眾號特有的接口。2、微信認證分為資質(zhì)認證和名稱認證兩部分，只需要資質(zhì)認證通過，就可獲得接口。接口名稱未認證訂閱號微信認證訂閱號未認證服務號微信認證服務號基礎(chǔ)支持-獲取access_token有有有有基礎(chǔ)支持-獲取微信服務器IP地址有有有有接收消息-驗證消息

5、真實性、接收普通消息、接收事件推送、接收語音識別結(jié)果有有有有發(fā)送消息-被動回復消息有有有有發(fā)送消息-客服接口有有發(fā)送消息-群發(fā)接口有有發(fā)送消息-模板消息接口（發(fā)送業(yè)務通知）有用戶管理-用戶分組管理有有用戶管理-設(shè)置用戶備注名有有用戶管理-獲取用戶基本信息有有用戶管理-獲取用戶列表有有用戶管理-獲取用戶地理位置有用戶管理-網(wǎng)頁授權(quán)獲取用戶openid/用戶基本信息有推廣支持-生成帶參數(shù)二維碼有推廣支持-長鏈接轉(zhuǎn)短鏈接口有界面豐富-自定義菜單有有有素材管理-素材管理接口有有智能接口-語義理解接口有多客服-獲取多客服消息記錄、客服管理有微信支付接口需申請微信小店接口需申請微信卡券接口需申請需申請微信

6、設(shè)備功能接口需申請微信JS-SDK-基礎(chǔ)接口有有有有微信JS-SDK-分享接口有有微信JS-SDK-圖像接口有有有有微信JS-SDK-音頻接口有有有有微信JS-SDK-智能接口（網(wǎng)頁語音識別）有有有有微信JS-SDK-設(shè)備信息有有有有微信JS-SDK-地理位置有有有有微信JS-SDK-界面操作有有有有微信JS-SDK-微信掃一掃有有有有微信JS-SDK-微信小店有微信JS-SDK-微信卡券有有微信JS-SDK-微信支付有access_token是公眾號的全局唯一票據(jù)，公眾號調(diào)用各接口時都需使用access_token。正常情況下access_token有效期為7200秒，重復獲取將導致上次獲取

7、的access_token失效。公眾號可以使用AppID和AppSecret調(diào)用本接口來獲取access_token。AppID和AppSecret可在開發(fā)模式中獲得（需要已經(jīng)成為開發(fā)者，且?guī)ぬ枦]有異常狀態(tài)）。注意調(diào)用所有微信接口時均需使用https協(xié)議。在微信后臺使用找到高級功能-開發(fā)模式-成為開發(fā)者就能看到appid和appsecert了出現(xiàn)40015-40028錯誤返回值都是跟菜單和按鈕相關(guān)的錯誤。只要是同一個微信開放平臺帳號下的移動應用、網(wǎng)站應用和公眾帳號，用戶的UnionID是唯一的。換句話說，同一用戶，對同一個微信開放平臺帳號下的不同應用，UnionID是相同的。詳情請在微信開放平

8、臺的資源中心-移動應用開發(fā)-微信登錄-授權(quán)關(guān)系接口調(diào)用指引-獲取用戶個人信息（UnionID機制）中查看。另請注意，微信公眾號接口只支持80接口。發(fā)送圖文消息（點擊跳轉(zhuǎn)到外鏈） 圖文消息條數(shù)限制在8條以內(nèi)，注意，如果圖文數(shù)超過8，則將會無響應。如果用戶在微信客戶端中訪問第三方網(wǎng)頁，公眾號可以通過微信網(wǎng)頁授權(quán)機制，來獲取用戶基本信息，進而實現(xiàn)業(yè)務邏輯。關(guān)于網(wǎng)頁授權(quán)回調(diào)域名的說明1、在微信公眾號請求用戶網(wǎng)頁授權(quán)之前，開發(fā)者需要先到公眾平臺官網(wǎng)中的開發(fā)者中心頁配置授權(quán)回調(diào)域名。請注意，這里填寫的是域名（是一個字符串），而不是URL，因此請勿加http:/等協(xié)議頭；2、授權(quán)回調(diào)域名配置規(guī)范為全域名，比

9、如需要網(wǎng)頁授權(quán)的域名為：，配置以后此域名下面的頁面 、 都可以進行OAuth2.0鑒權(quán)。但 、 、 無法進行OAuth2.0鑒權(quán)3、如果公眾號登錄授權(quán)給了第三方開發(fā)者來進行管理，則不必做任何設(shè)置，由第三方代替公眾號實現(xiàn)網(wǎng)頁授權(quán)即可關(guān)于網(wǎng)頁授權(quán)的兩種scope的區(qū)別說明1、以snsapi_base為scope發(fā)起的網(wǎng)頁授權(quán)，是用來獲取進入頁面的用戶的openid的，并且是靜默授權(quán)并自動跳轉(zhuǎn)到回調(diào)頁的。用戶感知的就是直接進入了回調(diào)頁（往往是業(yè)務頁面）2、以snsapi_userinfo為scope發(fā)起的網(wǎng)頁授權(quán)，是用來獲取用戶的基本信息的。但這種授權(quán)需要用戶手動同意，并且由于用戶同意過，所以無須關(guān)

10、注，就可在授權(quán)后獲取該用戶的基本信息。3、用戶管理類接口中的“獲取用戶基本信息接口”，是在用戶和公眾號產(chǎn)生消息交互或關(guān)注后事件推送后，才能根據(jù)用戶OpenID來獲取用戶基本信息。這個接口，包括其他微信接口，都是需要該用戶（即openid）關(guān)注了公眾號后，才能調(diào)用成功的。關(guān)于網(wǎng)頁授權(quán)access_token和普通access_token的區(qū)別1、微信網(wǎng)頁授權(quán)是通過OAuth2.0機制實現(xiàn)的，在用戶授權(quán)給公眾號后，公眾號可以獲取到一個網(wǎng)頁授權(quán)特有的接口調(diào)用憑證（網(wǎng)頁授權(quán)access_token），通過網(wǎng)頁授權(quán)access_token可以進行授權(quán)后接口調(diào)用，如獲取用戶基本信息；2、其他微信接口，需要

11、通過基礎(chǔ)支持中的“獲取access_token”接口來獲取到的普通access_token調(diào)用。關(guān)于UnionID機制1、請注意，網(wǎng)頁授權(quán)獲取用戶基本信息也遵循UnionID機制。即如果開發(fā)者有在多個公眾號，或在公眾號、移動應用之間統(tǒng)一用戶帳號的需求，需要前往微信開放平臺（）綁定公眾號后，才可利用UnionID機制來滿足上述需求。2、UnionID機制的作用說明：如果開發(fā)者擁有多個移動應用、網(wǎng)站應用和公眾帳號，可通過獲取用戶基本信息中的unionid來區(qū)分用戶的唯一性，因為同一用戶，對同一個微信開放平臺下的不同應用（移動應用、網(wǎng)站應用和公眾帳號），unionid是相同的。關(guān)于特殊場景下的靜默授

12、權(quán)1、上面已經(jīng)提到，對于以snsapi_base為scope的網(wǎng)頁授權(quán)，就靜默授權(quán)的，用戶無感知；2、對于已關(guān)注公眾號的用戶，如果用戶從公眾號的會話或者自定義菜單進入本公眾號的網(wǎng)頁授權(quán)頁，即使是scope為snsapi_userinfo，也是靜默授權(quán)，用戶無感知。具體而言，網(wǎng)頁授權(quán)流程分為四步：1、引導用戶進入授權(quán)頁面同意授權(quán)，獲取code2、通過code換取網(wǎng)頁授權(quán)access_token（與基礎(chǔ)支持中的access_token不同）3、如果需要，開發(fā)者可以刷新網(wǎng)頁授權(quán)access_token，避免過期4、通過網(wǎng)頁授權(quán)access_token和openid獲取用戶基本信息（支持UnionID

13、機制）目錄· 1 第一步：用戶同意授權(quán)，獲取code· 2 第二步：通過code換取網(wǎng)頁授權(quán)access_token· 3 第三步：刷新access_token（如果需要）· 4 第四步：拉取用戶信息(需scope為 snsapi_userinfo)· 5 附：檢驗授權(quán)憑證（access_token）是否有效第一步：用戶同意授權(quán)，獲取code在確保微信公眾賬號擁有授權(quán)作用域（scope參數(shù)）的權(quán)限的前提下（服務號獲得高級接口后，默認擁有scope參數(shù)中的snsapi_base和snsapi_us

14、erinfo），引導關(guān)注者打開如下頁面：若提示“該鏈接無法訪問”，請檢查參數(shù)是否填寫錯誤，是否擁有scope參數(shù)對應的授權(quán)作用域權(quán)限。尤其注意：由于授權(quán)操作安全等級較高，所以在發(fā)起授權(quán)請求時，微信會對授權(quán)鏈接做正則強匹配校驗，如果鏈接的參數(shù)順序不對，授權(quán)頁面將無法正常訪問參考鏈接(請在微信客戶端中打開此鏈接體驗)Scope為snsapi_baseScope為snsapi_userinfo尤其注意：跳轉(zhuǎn)回調(diào)redirect_uri，應當使用https鏈接來確保授權(quán)code的安全性。參數(shù)說明參數(shù)是否必須說明appid是公眾號的唯一標識redirect_uri是授權(quán)后重定向的回調(diào)鏈接地址，請使用ur

15、lencode對鏈接進行處理response_type是返回類型，請?zhí)顚慶odescope是應用授權(quán)作用域，snsapi_base （不彈出授權(quán)頁面，直接跳轉(zhuǎn)，只能獲取用戶openid），snsapi_userinfo （彈出授權(quán)頁面，可通過openid拿到昵稱、性別、所在地。并且，即使在未關(guān)注的情況下，只要用戶授權(quán)，也能獲取其信息）state否重定向后會帶上state參數(shù)，開發(fā)者可以填寫a-zA-Z0-9的參數(shù)值，最多128字節(jié)#wechat_redirect是無論直接打開還是做頁面302重定向時候，必須帶此參數(shù)下圖為scope等于snsapi_userinfo時的授權(quán)頁面：用戶同意授權(quán)后如

16、果用戶同意授權(quán)，頁面將跳轉(zhuǎn)至 redirect_uri/?code=CODE&state=STATE。若用戶禁止授權(quán)，則重定向后不會帶上code參數(shù)，僅會帶上state參數(shù)redirect_uri?state=STATEcode說明 ：code作為換取access_token的票據(jù)，每次用戶授權(quán)帶上的code將不一樣，code只能使用一次，5分鐘未被使用自動過期。第二步：通過code換取網(wǎng)頁授權(quán)access_token首先請注意，這里通過code換取的是一個特殊的網(wǎng)頁授權(quán)access_token,與基礎(chǔ)支持中的access_token（該access_token用于調(diào)用其他接口）不同。

17、公眾號可通過下述接口來獲取網(wǎng)頁授權(quán)access_token。如果網(wǎng)頁授權(quán)的作用域為snsapi_base，則本步驟中獲取到網(wǎng)頁授權(quán)access_token的同時，也獲取到了openid，snsapi_base式的網(wǎng)頁授權(quán)流程即到此為止。尤其注意：由于公眾號的secret和獲取到的access_token安全級別都非常高，必須只保存在服務器，不允許傳給客戶端。后續(xù)刷新access_token、通過access_token獲取用戶信息等步驟，也必須從服務器發(fā)起。請求方法獲取code后，請求以下鏈接獲取access_token： 參數(shù)說明參數(shù)是否必須說明appid是公眾號的唯一標識secret是公眾

18、號的appsecretcode是填寫第一步獲取的code參數(shù)grant_type是填寫為authorization_code返回說明正確時返回的JSON數(shù)據(jù)包如下： "access_token":"ACCESS_TOKEN", "expires_in":7200, "refresh_token":"REFRESH_TOKEN", "openid":"OPENID", "scope":"SCOPE", "un

19、ionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL"參數(shù)描述access_token網(wǎng)頁授權(quán)接口調(diào)用憑證,注意：此access_token與基礎(chǔ)支持的access_token不同expires_inaccess_token接口調(diào)用憑證超時時間，單位（秒）refresh_token用戶刷新access_tokenopenid用戶唯一標識，請注意，在未關(guān)注公眾號時，用戶訪問公眾號的網(wǎng)頁，也會產(chǎn)生一個用戶和公眾號唯一的OpenIDscope用戶授權(quán)的作用域，使用逗號（,）分隔unionid只有在用戶將公眾號綁定到微信開放平臺帳號后，才會出現(xiàn)該字

20、段。詳見：獲取用戶個人信息（UnionID機制）錯誤時微信會返回JSON數(shù)據(jù)包如下（示例為Code無效錯誤）:"errcode":40029,"errmsg":"invalid code"全局返回碼說明第三步：刷新access_token（如果需要）由于access_token擁有較短的有效期，當access_token超時后，可以使用refresh_token進行刷新，refresh_token擁有較長的有效期（7天、30天、60天、90天），當refresh_token失效的后，需要用戶重新授權(quán)。請求方法獲取第二步的refresh

21、_token后，請求以下鏈接獲取access_token： 參數(shù)是否必須說明appid是公眾號的唯一標識grant_type是填寫為refresh_tokenrefresh_token是填寫通過access_token獲取到的refresh_token參數(shù)返回說明正確時返回的JSON數(shù)據(jù)包如下： "access_token":"ACCESS_TOKEN", "expires_in":7200, "refresh_token":"REFRESH_TOKEN", "openid"

22、:"OPENID", "scope":"SCOPE"參數(shù)描述access_token網(wǎng)頁授權(quán)接口調(diào)用憑證,注意：此access_token與基礎(chǔ)支持的access_token不同expires_inaccess_token接口調(diào)用憑證超時時間，單位（秒）refresh_token用戶刷新access_tokenopenid用戶唯一標識scope用戶授權(quán)的作用域，使用逗號（,）分隔錯誤時微信會返回JSON數(shù)據(jù)包如下（示例為Code無效錯誤）:"errcode":40029,"errmsg":&qu

23、ot;invalid code"全局返回碼說明第四步：拉取用戶信息(需scope為 snsapi_userinfo)如果網(wǎng)頁授權(quán)作用域為snsapi_userinfo，則此時開發(fā)者可以通過access_token和openid拉取用戶信息了。請求方法http：GET（請使用https協(xié)議）參數(shù)說明參數(shù)描述access_token網(wǎng)頁授權(quán)接口調(diào)用憑證,注意：此access_token與基礎(chǔ)支持的access_token不同openid用戶的唯一標識lang返回國家地區(qū)語言版本，zh_CN 簡體，zh_TW 繁體，en 英語返回說明正確時返回的JSON數(shù)據(jù)包如下： "openi

24、d":" OPENID", " nickname": NICKNAME, "sex":"1", "province":"PROVINCE" "city":"CITY", "country":"COUNTRY", "headimgurl": " "privilege":"PRIVILEGE1""PRIVILEG

25、E2" , "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL"參數(shù)描述openid用戶的唯一標識nickname用戶昵稱sex用戶的性別，值為1時是男性，值為2時是女性，值為0時是未知province用戶個人資料填寫的省份city普通用戶個人資料填寫的城市country國家，如中國為CNheadimgurl用戶頭像，最后一個數(shù)值代表正方形頭像大?。ㄓ?、46、64、96、132數(shù)值可選，0代表640*640正方形頭像），用戶沒有頭像時該項為空。若用戶更換頭像，原有頭像URL將失效。privilege用戶特權(quán)信息

26、，json 數(shù)組，如微信沃卡用戶為（chinaunicom）unionid只有在用戶將公眾號綁定到微信開放平臺帳號后，才會出現(xiàn)該字段。詳見：獲取用戶個人信息（UnionID機制）錯誤時微信會返回JSON數(shù)據(jù)包如下（示例為openid無效）:"errcode":40003,"errmsg":" invalid openid "全局返回碼說明附：檢驗授權(quán)憑證（access_token）是否有效請求方法http：GET（請使用https協(xié)議）參數(shù)說明參數(shù)描述access_token網(wǎng)頁授權(quán)接口調(diào)用憑證,注意：此access_token與基礎(chǔ)

27、支持的access_token不同openid用戶的唯一標識返回說明正確的Json返回結(jié)果： "errcode":0,"errmsg":"ok"錯誤時的Json返回示例： "errcode":40003,"errmsg":"invalid openid"自定義菜單1.自定義菜單創(chuàng)建接口自定義菜單能夠幫助公眾號豐富界面，讓用戶更好更快地理解公眾號的功能。開啟自定義菜單后，公眾號界面如圖所示：請注意：1、自定義菜單最多包括3個一級菜單，每個一級菜單最多包含5個二級菜單。2、一級菜

28、單最多4個漢字，二級菜單最多7個漢字，多出來的部分將會以“.”代替。3、創(chuàng)建自定義菜單后，由于微信客戶端緩存，需要24小時微信客戶端才會展現(xiàn)出來。測試時可以嘗試取消關(guān)注公眾賬號后再次關(guān)注，則可以看到創(chuàng)建后的效果。自定義菜單接口可實現(xiàn)多種類型按鈕，如下：1、click：點擊推事件用戶點擊click類型按鈕后，微信服務器會通過消息接口推送消息類型為event的結(jié)構(gòu)給開發(fā)者（參考消息接口指南），并且?guī)习粹o中開發(fā)者填寫的key值，開發(fā)者可以通過自定義的key值與用戶進行交互；2、view：跳轉(zhuǎn)URL用戶點擊view類型按鈕后，微信客戶端將會打開開發(fā)者在按鈕中填寫的網(wǎng)頁URL，可與網(wǎng)頁授權(quán)獲取用戶基本

29、信息接口結(jié)合，獲得用戶基本信息。3、scancode_push：掃碼推事件用戶點擊按鈕后，微信客戶端將調(diào)起掃一掃工具，完成掃碼操作后顯示掃描結(jié)果（如果是URL，將進入URL），且會將掃碼的結(jié)果傳給開發(fā)者，開發(fā)者可以下發(fā)消息。4、scancode_waitmsg：掃碼推事件且彈出“消息接收中”提示框用戶點擊按鈕后，微信客戶端將調(diào)起掃一掃工具，完成掃碼操作后，將掃碼的結(jié)果傳給開發(fā)者，同時收起掃一掃工具，然后彈出“消息接收中”提示框，隨后可能會收到開發(fā)者下發(fā)的消息。5、pic_sysphoto：彈出系統(tǒng)拍照發(fā)圖用戶點擊按鈕后，微信客戶端將調(diào)起系統(tǒng)相機，完成拍照操作后，會將拍攝的相片發(fā)送給開發(fā)者，并推

30、送事件給開發(fā)者，同時收起系統(tǒng)相機，隨后可能會收到開發(fā)者下發(fā)的消息。6、pic_photo_or_album：彈出拍照或者相冊發(fā)圖用戶點擊按鈕后，微信客戶端將彈出選擇器供用戶選擇“拍照”或者“從手機相冊選擇”。用戶選擇后即走其他兩種流程。7、pic_weixin：彈出微信相冊發(fā)圖器用戶點擊按鈕后，微信客戶端將調(diào)起微信相冊，完成選擇操作后，將選擇的相片發(fā)送給開發(fā)者的服務器，并推送事件給開發(fā)者，同時收起相冊，隨后可能會收到開發(fā)者下發(fā)的消息。8、location_select：彈出地理位置選擇器用戶點擊按鈕后，微信客戶端將調(diào)起地理位置選擇工具，完成選擇操作后，將選擇的地理位置發(fā)送給開發(fā)者的服務器，同時

31、收起位置選擇工具，隨后可能會收到開發(fā)者下發(fā)的消息。9、media_id：下發(fā)消息（除文本消息）用戶點擊media_id類型按鈕后，微信服務器會將開發(fā)者填寫的永久素材id對應的素材下發(fā)給用戶，永久素材類型可以是圖片、音頻、視頻、圖文消息。請注意：永久素材id必須是在“素材管理/新增永久素材”接口上傳后獲得的合法id。10、view_limited：跳轉(zhuǎn)圖文消息URL用戶點擊view_limited類型按鈕后，微信客戶端將打開開發(fā)者在按鈕中填寫的永久素材id對應的圖文消息URL，永久素材類型只支持圖文消息。請注意：永久素材id必須是在“素材管理/新增永久素材”接口上傳后獲得的合法id。請注意，3到

32、8的所有事件，僅支持微信iPhone5.4.1以上版本，和Android5.4以上版本的微信用戶，舊版本微信用戶點擊后將沒有回應，開發(fā)者也不能正常接收到事件推送。9和10，是專門給第三方平臺旗下未微信認證（具體而言，是資質(zhì)認證未通過）的訂閱號準備的事件類型，它們是沒有事件推送的，能力相對受限，其他類型的公眾號不必使用。接口調(diào)用請求說明http請求方式：POST（請使用https協(xié)議） click和view的請求示例 "button": "type":"click", "name":"今日歌曲&q

33、uot;, "key":"V1001_TODAY_MUSIC" , "name":"菜單", "sub_button": "type":"view", "name":"搜索", "url":" , "type":"view", "name":"視頻", "url":" , &qu

34、ot;type":"click", "name":"贊一下我們", "key":"V1001_GOOD" 其他新增按鈕類型的請求示例 "button": "name": "掃碼", "sub_button": "type": "scancode_waitmsg", "name": "掃碼帶提示", "key"

35、: "rselfmenu_0_0", "sub_button": , "type": "scancode_push", "name": "掃碼推事件", "key": "rselfmenu_0_1", "sub_button": , "name": "發(fā)圖", "sub_button": "type": "pic_sysphot

36、o", "name": "系統(tǒng)拍照發(fā)圖", "key": "rselfmenu_1_0", "sub_button": , "type": "pic_photo_or_album", "name": "拍照或者相冊發(fā)圖", "key": "rselfmenu_1_1", "sub_button": , "type": "

37、;pic_weixin", "name": "微信相冊發(fā)圖", "key": "rselfmenu_1_2", "sub_button": , "name": "發(fā)送位置", "type": "location_select", "key": "rselfmenu_2_0" , "type": "media_id", "

38、;name": "圖片", "media_id": "MEDIA_ID1" , "type": "view_limited", "name": "圖文消息", "media_id": "MEDIA_ID2" 參數(shù)說明參數(shù)是否必須說明button是一級菜單數(shù)組，個數(shù)應為13個sub_button否二級菜單數(shù)組，個數(shù)應為15個type是菜單的響應動作類型name是菜單標題，不超過16個字節(jié)，子菜單不超過40個字

39、節(jié)keyclick等點擊類型必須菜單KEY值，用于消息接口推送，不超過128字節(jié)urlview類型必須網(wǎng)頁鏈接，用戶點擊菜單可打開鏈接，不超過256字節(jié)media_idmedia_id類型和view_limited類型必須調(diào)用新增永久素材接口返回的合法media_id返回結(jié)果正確時的返回JSON數(shù)據(jù)包如下："errcode":0,"errmsg":"ok"錯誤時的返回JSON數(shù)據(jù)包如下（示例為無效菜單名長度）："errcode":40018,"errmsg":"invalid butt

40、on name size"全局返回碼說明使用網(wǎng)頁調(diào)試工具調(diào)試該接口2.自定義菜單查詢接口使用接口創(chuàng)建自定義菜單后，開發(fā)者還可使用接口查詢自定義菜單的結(jié)構(gòu)。請求說明http請求方式：GET返回說明對應創(chuàng)建接口，正確的Json返回結(jié)果:"menu":"button":"type":"click","name":"今日歌曲","key":"V1001_TODAY_MUSIC","sub_button":,&quo

41、t;type":"click","name":"歌手簡介","key":"V1001_TODAY_SINGER","sub_button":,"name":"菜單","sub_button":"type":"view","name":"搜索","url":"統(tǒng)一返回碼說明使用網(wǎng)頁調(diào)試工具調(diào)試該接口3

42、自定義菜單刪除接口使用接口創(chuàng)建自定義菜單后，開發(fā)者還可使用接口刪除當前使用的自定義菜單。請求說明http請求方式：GET返回說明對應創(chuàng)建接口，正確的Json返回結(jié)果:"errcode":0,"errmsg":"ok"統(tǒng)一返回碼說明使用網(wǎng)頁調(diào)試工具調(diào)試該接口4.自定義菜單事件推送用戶點擊自定義菜單后，微信會把點擊事件推送給開發(fā)者，請注意，點擊菜單彈出子菜單，不會產(chǎn)生上報。請注意，第3個到第8個的所有事件，僅支持微信iPhone5.4.1以上版本，和Android5.4以上版本的微信用戶，舊版本微信用戶點擊后將沒有回應，開發(fā)者也不能正常接

43、收到事件推送。目錄· 1 點擊菜單拉取消息時的事件推送· 2 點擊菜單跳轉(zhuǎn)鏈接時的事件推送· 3 scancode_push：掃碼推事件的事件推送· 4 scancode_waitmsg：掃碼推事件且彈出“消息接收中”提示框的事件推送· 5 pic_sysphoto：彈出系統(tǒng)拍照發(fā)圖的事件推送· 6 pic_photo_or_album：彈出拍照或者相冊發(fā)圖的事件推送· 7 pic_weixin：彈出微信相冊發(fā)圖器的事件推送· 8 lo

44、cation_select：彈出地理位置選擇器的事件推送點擊菜單拉取消息時的事件推送推送XML數(shù)據(jù)包示例：<xml><ToUserName><!CDATAtoUser></ToUserName><FromUserName><!CDATAFromUser></FromUserName><CreateTime>123456789</CreateTime><MsgType><!CDATAevent></MsgType><Event><!CD

45、ATACLICK></Event><EventKey><!CDATAEVENTKEY></EventKey></xml>參數(shù)說明：參數(shù)描述ToUserName開發(fā)者微信號FromUserName發(fā)送方帳號（一個OpenID）CreateTime消息創(chuàng)建時間 （整型）MsgType消息類型，eventEvent事件類型，CLICKEventKey事件KEY值，與自定義菜單接口中KEY值對應點擊菜單跳轉(zhuǎn)鏈接時的事件推送推送XML數(shù)據(jù)包示例：<xml><ToUserName><!CDATAtoUser&g

46、t;</ToUserName><FromUserName><!CDATAFromUser></FromUserName><CreateTime>123456789</CreateTime><MsgType><!CDATAevent></MsgType><Event><!CDATAVIEW></Event><EventKey><!CDATA></EventKey></xml>參數(shù)說明：參數(shù)描述ToUserN

47、ame開發(fā)者微信號FromUserName發(fā)送方帳號（一個OpenID）CreateTime消息創(chuàng)建時間 （整型）MsgType消息類型，eventEvent事件類型，VIEWEventKey事件KEY值，設(shè)置的跳轉(zhuǎn)URLscancode_push：掃碼推事件的事件推送推送XML數(shù)據(jù)包示例：<xml><ToUserName><!CDATAgh_e136c6e50636></ToUserName><FromUserName><!CDATAoMgHVjngRipVsoxg6TuX3vz6glDg></FromUserNa

48、me><CreateTime>1408090502</CreateTime><MsgType><!CDATAevent></MsgType><Event><!CDATAscancode_push></Event><EventKey><!CDATA6></EventKey><ScanCodeInfo><ScanType><!CDATAqrcode></ScanType><ScanResult><

49、!CDATA1></ScanResult></ScanCodeInfo></xml>參數(shù)說明：參數(shù)描述ToUserName開發(fā)者微信號FromUserName發(fā)送方帳號（一個OpenID）CreateTime消息創(chuàng)建時間（整型）MsgType消息類型，eventEvent事件類型，scancode_pushEventKey事件KEY值，由開發(fā)者在創(chuàng)建菜單時設(shè)定ScanCodeInfo掃描信息ScanType掃描類型，一般是qrcodeScanResult掃描結(jié)果，即二維碼對應的字符串信息scancode_waitmsg：掃碼推事件且彈出“消息接收中”提

50、示框的事件推送推送XML數(shù)據(jù)包示例：<xml><ToUserName><!CDATAgh_e136c6e50636></ToUserName><FromUserName><!CDATAoMgHVjngRipVsoxg6TuX3vz6glDg></FromUserName><CreateTime>1408090606</CreateTime><MsgType><!CDATAevent></MsgType><Event><!CDATAsc

51、ancode_waitmsg></Event><EventKey><!CDATA6></EventKey><ScanCodeInfo><ScanType><!CDATAqrcode></ScanType><ScanResult><!CDATA2></ScanResult></ScanCodeInfo></xml>參數(shù)說明：參數(shù)描述ToUserName開發(fā)者微信號FromUserName發(fā)送方帳號（一個OpenID）CreateTime

52、消息創(chuàng)建時間 （整型）MsgType消息類型，eventEvent事件類型，scancode_waitmsgEventKey事件KEY值，由開發(fā)者在創(chuàng)建菜單時設(shè)定ScanCodeInfo掃描信息ScanType掃描類型，一般是qrcodeScanResult掃描結(jié)果，即二維碼對應的字符串信息pic_sysphoto：彈出系統(tǒng)拍照發(fā)圖的事件推送推送XML數(shù)據(jù)包示例：<xml><ToUserName><!CDATAgh_e136c6e50636></ToUserName><FromUserName><!CDATAoMgHVjngRi

53、pVsoxg6TuX3vz6glDg></FromUserName><CreateTime>1408090651</CreateTime><MsgType><!CDATAevent></MsgType><Event><!CDATApic_sysphoto></Event><EventKey><!CDATA6></EventKey><SendPicsInfo><Count>1</Count><PicList><item><PicMd5Sum><!CDATA1b5f7c23b5bf75682a53e7b6d163e185></PicMd5Sum></item></PicList></SendPicsInfo></xml>參數(shù)說明：參數(shù)描述ToUserName開發(fā)者微信號FromUserName發(fā)