微信開(kāi)發(fā)筆記

1、1、僅應(yīng)當(dāng)收集為運(yùn)營(yíng)及功能實(shí)現(xiàn)目的而必要的用戶數(shù)據(jù)，同時(shí)應(yīng)當(dāng)告知用戶相關(guān)數(shù)據(jù)收集的目的、范圍及使用方式等，保障用戶知情權(quán)。公眾號(hào)調(diào)用接口并不是無(wú)限制的。為了防止公眾號(hào)的程序錯(cuò)誤而引發(fā)微信服務(wù)器負(fù)載異常，默認(rèn)情況下，每個(gè)公眾號(hào)調(diào)用接口都不能超過(guò)一定限制，當(dāng)超過(guò)一定限制時(shí)，調(diào)用對(duì)應(yīng)接口會(huì)收到如下錯(cuò)誤返回碼：errcode:45009,errmsg:api freq out of limit 開(kāi)發(fā)者可以登錄微信公眾平臺(tái)，在帳號(hào)后臺(tái)開(kāi)發(fā)者中心接口權(quán)限模板查看帳號(hào)各接口當(dāng)前的日調(diào)用上限和實(shí)時(shí)調(diào)用量，對(duì)于認(rèn)證帳號(hào)可以對(duì)實(shí)時(shí)調(diào)用量清零，說(shuō)明如下：1、目前清零功能只對(duì)認(rèn)證帳號(hào)開(kāi)放。2、由于指標(biāo)計(jì)算方法或統(tǒng)計(jì)時(shí)

2、間差異，實(shí)時(shí)調(diào)用量數(shù)據(jù)可能會(huì)出現(xiàn)誤差，一般在1%以內(nèi)。3、每個(gè)帳號(hào)每月共10 次清零操作機(jī)會(huì)，清零生效一次即用掉一次機(jī)會(huì)。4、清零機(jī)會(huì)可以10 次都用在對(duì)同一個(gè)接口進(jìn)行清零，也可以用在不同接口上。5、每個(gè)有接口調(diào)用限額的接口都可以進(jìn)行清零操作。6、清零一次后，只有確認(rèn)清零的接口才會(huì)生效，不是清零所有接口。新注冊(cè)帳號(hào)各接口調(diào)用頻率限制如下：接口每日限額獲取 access_token 2000 自定義菜單創(chuàng)建1000 自定義菜單查詢10000 自定義菜單刪除1000 創(chuàng)建分組1000 獲取分組1000 修改分組名1000 移動(dòng)用戶分組100000 上傳多媒體文件5000 下載多媒體文件10000

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

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

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

6、 - 獲取多客服消息記錄、客服管理有微信支付接口需申請(qǐng)微信小店接口需申請(qǐng)微信卡券接口需申請(qǐng)需申請(qǐng)微信設(shè)備功能接口需申請(qǐng)微信 js-sdk-基礎(chǔ)接口有有有有微信 js-sdk-分享接口有有微信 js-sdk-圖像接口有有有有微信 js-sdk-音頻接口有有有有微信 js-sdk-智能接口（網(wǎng)頁(yè)語(yǔ)音識(shí)別）有有有有微信 js-sdk-設(shè)備信息有有有有微信 js-sdk-地理位置有有有有微信 js-sdk-界面操作有有有有微信 js-sdk-微信掃一掃有有有有微信 js-sdk-微信小店有微信 js-sdk-微信卡券有有微信 js-sdk-微信支付有access_token是公眾號(hào)的全局唯一票據(jù)，公眾

7、號(hào)調(diào)用各接口時(shí)都需使用access_token。正常情況下 access_token有效期為 7200秒，重復(fù)獲取將導(dǎo)致上次獲取的access_token失效。公眾號(hào)可以使用appid和 appsecret調(diào)用本接口來(lái)獲取access_token。appid和 appsecret可在開(kāi)發(fā)模式中獲得（需要已經(jīng)成為開(kāi)發(fā)者，且?guī)ぬ?hào)沒(méi)有異常狀態(tài)）。注意調(diào)用所有微信接口時(shí)均需使用 https協(xié)議。在微信后臺(tái)使用找到高級(jí)功能-開(kāi)發(fā)模式 - 成為開(kāi)發(fā)者就能看到appid 和 appsecert了出現(xiàn) 40015-40028錯(cuò)誤返回值都是跟菜單和按鈕相關(guān)的錯(cuò)誤。只要是同一個(gè)微信開(kāi)放平臺(tái)帳號(hào)下的移動(dòng)應(yīng)用、網(wǎng)站應(yīng)

8、用和公眾帳號(hào)， 用戶的 unionid 是唯一的。換句話說(shuō)，同一用戶，對(duì)同一個(gè)微信開(kāi)放平臺(tái)帳號(hào)下的不同應(yīng)用，unionid 是相同的。 詳情請(qǐng)?jiān)谖⑿砰_(kāi)放平臺(tái)的資源中心- 移動(dòng)應(yīng)用開(kāi)發(fā) - 微信登錄 -授權(quán)關(guān)系接口調(diào)用指引-獲取用戶個(gè)人信息（unionid 機(jī)制）中查看。另請(qǐng)注意， 微信公眾號(hào)接口只支持80 接口。發(fā)送圖文消息（點(diǎn)擊跳轉(zhuǎn)到外鏈）圖文消息條數(shù)限制在8 條以內(nèi)，注意，如果圖文數(shù)超過(guò)8，則將會(huì)無(wú)響應(yīng)。如果用戶在微信客戶端中訪問(wèn)第三方網(wǎng)頁(yè)，公眾號(hào)可以通過(guò)微信網(wǎng)頁(yè)授權(quán)機(jī)制，來(lái)獲取用戶基本信息，進(jìn)而實(shí)現(xiàn)業(yè)務(wù)邏輯。關(guān)于網(wǎng)頁(yè)授權(quán)回調(diào)域名的說(shuō)明1、在微信公眾號(hào)請(qǐng)求用戶網(wǎng)頁(yè)授權(quán)之前，開(kāi)發(fā)者需要先到公

9、眾平臺(tái)官網(wǎng)中的開(kāi)發(fā)者中心頁(yè)配置授權(quán)回調(diào)域名。請(qǐng)注意，這里填寫(xiě)的是域名（是一個(gè)字符串），而不是url，因此請(qǐng)勿加 http:/等協(xié)議頭；2、授權(quán)回調(diào)域名配置規(guī)范為全域名，比如需要網(wǎng)頁(yè)授權(quán)的域名為： ，配置以后此域名下面的頁(yè)面http:/ http:/ oauth2.0鑒權(quán)。但http:/、 http:/、 http:/無(wú)法進(jìn)行 oauth2.0鑒權(quán)3、如果公眾號(hào)登錄授權(quán)給了第三方開(kāi)發(fā)者來(lái)進(jìn)行管理，則不必做任何設(shè)置，由第三方代替公眾號(hào)實(shí)現(xiàn)網(wǎng)頁(yè)授權(quán)即可關(guān)于網(wǎng)頁(yè)授權(quán)的兩種scope 的區(qū)別說(shuō)明1、以 snsapi_base為 scope 發(fā)起的網(wǎng)頁(yè)授權(quán)，是用來(lái)獲取進(jìn)入頁(yè)面的用戶的openid的，并且是

10、靜默授權(quán)并自動(dòng)跳轉(zhuǎn)到回調(diào)頁(yè)的。用戶感知的就是直接進(jìn)入了回調(diào)頁(yè)（往往是業(yè)務(wù)頁(yè)面）2、以 snsapi_userinfo為 scope發(fā)起的網(wǎng)頁(yè)授權(quán)，是用來(lái)獲取用戶的基本信息的。但這種授權(quán)需要用戶手動(dòng)同意，并且由于用戶同意過(guò)，所以無(wú)須關(guān)注，就可在授權(quán)后獲取該用戶的基本信息。3、用戶管理類接口中的 “ 獲取用戶基本信息接口 ” ，是在用戶和公眾號(hào)產(chǎn)生消息交互或關(guān)注后事件推送后，才能根據(jù)用戶 openid 來(lái)獲取用戶基本信息。這個(gè)接口，包括其他微信接口，都是需要該用戶（即openid）關(guān)注了公眾號(hào)后，才能調(diào)用成功的。關(guān)于網(wǎng)頁(yè)授權(quán)access_token 和普通 access_token的區(qū)別1、微信網(wǎng)

11、頁(yè)授權(quán)是通過(guò)oauth2.0機(jī)制實(shí)現(xiàn)的，在用戶授權(quán)給公眾號(hào)后，公眾號(hào)可以獲取到一個(gè)網(wǎng)頁(yè)授權(quán)特有的接口調(diào)用憑證（網(wǎng)頁(yè)授權(quán)access_token），通過(guò)網(wǎng)頁(yè)授權(quán) access_token可以進(jìn)行授權(quán)后接口調(diào)用，如獲取用戶基本信息；2、其他微信接口，需要通過(guò)基礎(chǔ)支持中的“ 獲取 access_token ”接口來(lái)獲取到的普通access_token調(diào)用。關(guān)于 unionid 機(jī)制1、請(qǐng)注意，網(wǎng)頁(yè)授權(quán)獲取用戶基本信息也遵循unionid機(jī)制。即如果開(kāi)發(fā)者有在多個(gè)公眾號(hào)，或在公眾號(hào)、移動(dòng)應(yīng)用之間統(tǒng)一用戶帳號(hào)的需求，需要前往微信開(kāi)放平臺(tái)（）綁定公眾號(hào)后，才可利用unionid機(jī)制來(lái)滿足上述需求。2、un

12、ionid機(jī)制的作用說(shuō)明：如果開(kāi)發(fā)者擁有多個(gè)移動(dòng)應(yīng)用、網(wǎng)站應(yīng)用和公眾帳號(hào)，可通過(guò)獲取用戶基本信息中的unionid來(lái)區(qū)分用戶的唯一性，因?yàn)橥挥脩?，?duì)同一個(gè)微信開(kāi)放平臺(tái)下的不同應(yīng)用（移動(dòng)應(yīng)用、網(wǎng)站應(yīng)用和公眾帳號(hào)）， unionid是相同的。關(guān)于特殊場(chǎng)景下的靜默授權(quán)1、上面已經(jīng)提到，對(duì)于以snsapi_base為 scope的網(wǎng)頁(yè)授權(quán)，就靜默授權(quán)的，用戶無(wú)感知；2、對(duì)于已關(guān)注公眾號(hào)的用戶，如果用戶從公眾號(hào)的會(huì)話或者自定義菜單進(jìn)入本公眾號(hào)的網(wǎng)頁(yè)授權(quán)頁(yè)，即使是scope為 snsapi_userinfo，也是靜默授權(quán)，用戶無(wú)感知。具體而言，網(wǎng)頁(yè)授權(quán)流程分為四步：1、引導(dǎo)用戶進(jìn)入授權(quán)頁(yè)面同意授權(quán)，獲取

13、code 2、通過(guò) code 換取網(wǎng)頁(yè)授權(quán) access_token（與基礎(chǔ)支持中的access_token不同）3、如果需要，開(kāi)發(fā)者可以刷新網(wǎng)頁(yè)授權(quán)access_token，避免過(guò)期4、通過(guò)網(wǎng)頁(yè)授權(quán) access_token和 openid獲取用戶基本信息（支持unionid機(jī)制）目錄1第一步：用戶同意授權(quán)，獲取code2第二步：通過(guò) code 換取網(wǎng)頁(yè)授權(quán) access_token3第三步：刷新 access_token （如果需要）4第四步：拉取用戶信息 ( 需 scope 為 snsapi_userinfo)5附：檢驗(yàn)授權(quán)憑證（ access_token ）是否有效第一步：用戶同意授權(quán)

14、，獲取code在確保微信公眾賬號(hào)擁有授權(quán)作用域（scope 參數(shù)）的權(quán)限的前提下（服務(wù)號(hào)獲得高級(jí)接口后，默認(rèn)擁有 scope 參數(shù)中的 snsapi_base 和 snsapi_userinfo），引導(dǎo)關(guān)注者打開(kāi)如下頁(yè)面：https:/ “ 該鏈接無(wú)法訪問(wèn) ” ，請(qǐng)檢查參數(shù)是否填寫(xiě)錯(cuò)誤，是否擁有scope參數(shù)對(duì)應(yīng)的授權(quán)作用域權(quán)限。尤其注意：由于授權(quán)操作安全等級(jí)較高，所以在發(fā)起授權(quán)請(qǐng)求時(shí)，微信會(huì)對(duì)授權(quán)鏈接做正則強(qiáng)匹配校驗(yàn)，如果鏈接的參數(shù)順序不對(duì)，授權(quán)頁(yè)面將無(wú)法正常訪問(wèn)參考鏈接 ( 請(qǐng)?jiān)谖⑿趴蛻舳酥写蜷_(kāi)此鏈接體驗(yàn))scope 為 snsapi_basehttps:/ scope 為 snsapi_

15、userinfohttps:/ https鏈接來(lái)確保授權(quán)code 的安全性。參數(shù)說(shuō)明參數(shù)是否必須說(shuō)明appid 是公眾號(hào)的唯一標(biāo)識(shí)redirect_uri 是授權(quán)后重定向的回調(diào)鏈接地址，請(qǐng)使用urlencode對(duì)鏈接進(jìn)行處理response_type 是返回類型，請(qǐng)?zhí)顚?xiě)code scope 是應(yīng)用授權(quán)作用域， snsapi_base （不彈出授權(quán)頁(yè)面，直接跳轉(zhuǎn)，只能獲取用戶openid ），snsapi_userinfo （彈出授權(quán)頁(yè)面，可通過(guò) openid 拿到昵稱、性別、所在地。并且，即使在未關(guān)注的情況下，只要用戶授權(quán)，也能獲取其信息）state 否重定向后會(huì)帶上state參數(shù)，開(kāi)發(fā)者可以

16、填寫(xiě)a-za-z0-9 的參數(shù)值，最多 128 字節(jié)#wechat_redirect 是無(wú)論直接打開(kāi)還是做頁(yè)面302 重定向時(shí)候，必須帶此參數(shù)下圖為 scope 等于 snsapi_userinfo時(shí)的授權(quán)頁(yè)面：用戶同意授權(quán)后如果用戶同意授權(quán)，頁(yè)面將跳轉(zhuǎn)至 redirect_uri/?code=code&state=state。若用戶禁止授權(quán)，則重定向后不會(huì)帶上code 參數(shù)，僅會(huì)帶上state參數(shù) redirect_uri?state=state code 說(shuō)明 ：code 作為換取 access_token的票據(jù)，每次用戶授權(quán)帶上的code 將不一樣， code 只能使用一次， 5

17、 分鐘未被使用自動(dòng)過(guò)期。第二步：通過(guò)code 換取網(wǎng)頁(yè)授權(quán)access_token首先請(qǐng)注意，這里通過(guò)code 換取的是一個(gè)特殊的網(wǎng)頁(yè)授權(quán)access_token, 與基礎(chǔ)支持中的access_token （該 access_token 用于調(diào)用其他接口）不同。公眾號(hào)可通過(guò)下述接口來(lái)獲取網(wǎng)頁(yè)授權(quán) access_token 。如果網(wǎng)頁(yè)授權(quán)的作用域?yàn)閟nsapi_base ，則本步驟中獲取到網(wǎng)頁(yè)授權(quán)access_token 的同時(shí)，也獲取到了openid ，snsapi_base 式的網(wǎng)頁(yè)授權(quán)流程即到此為止。尤其注意：由于公眾號(hào)的secret和獲取到的 access_token 安全級(jí)別都非常高，

18、必須只保存在服務(wù)器，不允許傳給客戶端。后續(xù)刷新access_token 、通過(guò) access_token獲取用戶信息等步驟，也必須從服務(wù)器發(fā)起。請(qǐng)求方法獲取 code 后，請(qǐng)求以下鏈接獲取access_token：https:/ 是公眾號(hào)的唯一標(biāo)識(shí)secret 是公眾號(hào)的 appsecret code 是填寫(xiě)第一步獲取的code 參數(shù)grant_type 是填寫(xiě)為 authorization_code 返回說(shuō)明正確時(shí)返回的json 數(shù)據(jù)包如下： access_token:access_token, expires_in:7200, refresh_token:refresh_token, op

19、enid:openid, scope:scope, unionid: o6_bmasdasdsad6_2sgvt7hmzopfl 參數(shù)描述access_token 網(wǎng)頁(yè)授權(quán)接口調(diào)用憑證, 注意：此 access_token與基礎(chǔ)支持的 access_token不同expires_in access_token接口調(diào)用憑證超時(shí)時(shí)間，單位（秒）refresh_token 用戶刷新 access_token openid 用戶唯一標(biāo)識(shí)，請(qǐng)注意，在未關(guān)注公眾號(hào)時(shí)，用戶訪問(wèn)公眾號(hào)的網(wǎng)頁(yè)，也會(huì)產(chǎn)生一個(gè)用戶和公眾號(hào)唯一的openid scope 用戶授權(quán)的作用域，使用逗號(hào)（, ）分隔unionid 只有在用

20、戶將公眾號(hào)綁定到微信開(kāi)放平臺(tái)帳號(hào)后，才會(huì)出現(xiàn)該字段。詳見(jiàn)：獲取用戶個(gè)人信息（unionid 機(jī)制）錯(cuò)誤時(shí)微信會(huì)返回json數(shù)據(jù)包如下（示例為code無(wú)效錯(cuò)誤） : errcode:40029,errmsg:invalid code 全局返回碼說(shuō)明第三步：刷新access_token （如果需要）由于 access_token 擁有較短的有效期，當(dāng)access_token 超時(shí)后，可以使用refresh_token進(jìn)行刷新， refresh_token擁有較長(zhǎng)的有效期（ 7 天、30 天、60 天、 90 天），當(dāng) refresh_token失效的后，需要用戶重新授權(quán)。請(qǐng)求方法獲取第二步的 re

21、fresh_token后，請(qǐng)求以下鏈接獲取access_token：https:/ 是公眾號(hào)的唯一標(biāo)識(shí)grant_type 是填寫(xiě)為 refresh_token refresh_token 是填寫(xiě)通過(guò) access_token 獲取到的 refresh_token參數(shù)返回說(shuō)明正確時(shí)返回的json 數(shù)據(jù)包如下： access_token:access_token, expires_in:7200, refresh_token:refresh_token, openid:openid, scope:scope 參數(shù)描述access_token 網(wǎng)頁(yè)授權(quán)接口調(diào)用憑證, 注意：此 access_tok

22、en 與基礎(chǔ)支持的access_token 不同expires_in access_token 接口調(diào)用憑證超時(shí)時(shí)間，單位（秒）refresh_token 用戶刷新 access_token openid 用戶唯一標(biāo)識(shí)scope 用戶授權(quán)的作用域，使用逗號(hào)（, ）分隔錯(cuò)誤時(shí)微信會(huì)返回json數(shù)據(jù)包如下（示例為code無(wú)效錯(cuò)誤） : errcode:40029,errmsg:invalid code 全局返回碼說(shuō)明第四步：拉取用戶信息( 需 scope 為 snsapi_userinfo)如果網(wǎng)頁(yè)授權(quán)作用域?yàn)閟nsapi_userinfo， 則此時(shí)開(kāi)發(fā)者可以通過(guò)access_token 和 op

23、enid 拉取用戶信息了。請(qǐng)求方法http：get（請(qǐng)使用 https協(xié)議）https:/ 網(wǎng)頁(yè)授權(quán)接口調(diào)用憑證, 注意：此 access_token與基礎(chǔ)支持的access_token 不同openid 用戶的唯一標(biāo)識(shí)lang 返回國(guó)家地區(qū)語(yǔ)言版本，zh_cn 簡(jiǎn)體， zh_tw 繁體， en 英語(yǔ)返回說(shuō)明正確時(shí)返回的json 數(shù)據(jù)包如下： openid: openid, nickname: nickname, sex:1, province:province city:city, country:country, headimgurl: http:/ privilege: privileg

24、e1 privilege2 , unionid: o6_bmasdasdsad6_2sgvt7hmzopfl 參數(shù)描述openid 用戶的唯一標(biāo)識(shí)nickname 用戶昵稱sex 用戶的性別，值為1 時(shí)是男性，值為2 時(shí)是女性，值為0 時(shí)是未知province 用戶個(gè)人資料填寫(xiě)的省份city 普通用戶個(gè)人資料填寫(xiě)的城市country 國(guó)家，如中國(guó)為cn headimgurl 用戶頭像， 最后一個(gè)數(shù)值代表正方形頭像大?。ㄓ?0、46、64、96、132 數(shù)值可選，0 代表 640*640 正方形頭像），用戶沒(méi)有頭像時(shí)該項(xiàng)為空。若用戶更換頭像，原有頭像 url將失效。privilege 用戶特權(quán)信

25、息， json 數(shù)組，如微信沃卡用戶為（chinaunicom ）unionid 只有在用戶將公眾號(hào)綁定到微信開(kāi)放平臺(tái)帳號(hào)后，才會(huì)出現(xiàn)該字段。詳見(jiàn)：獲取用戶個(gè)人信息（ unionid 機(jī)制）錯(cuò)誤時(shí)微信會(huì)返回json數(shù)據(jù)包如下（示例為openid 無(wú)效） : errcode:40003,errmsg: invalid openid 全局返回碼說(shuō)明附：檢驗(yàn)授權(quán)憑證（access_token ）是否有效請(qǐng)求方法http：get（請(qǐng)使用 https協(xié)議）https:/ 網(wǎng)頁(yè)授權(quán)接口調(diào)用憑證, 注意：此 access_token與基礎(chǔ)支持的access_token 不同openid 用戶的唯一標(biāo)識(shí)返回說(shuō)

26、明正確的 json 返回結(jié)果： errcode:0,errmsg:ok 錯(cuò)誤時(shí)的 json 返回示例： errcode:40003,errmsg:invalid openid 自定義菜單1.自定義菜單創(chuàng)建接口自定義菜單能夠幫助公眾號(hào)豐富界面，讓用戶更好更快地理解公眾號(hào)的功能。開(kāi)啟自定義菜單后，公眾號(hào)界面如圖所示：請(qǐng)注意：1、自定義菜單最多包括3 個(gè)一級(jí)菜單，每個(gè)一級(jí)菜單最多包含5 個(gè)二級(jí)菜單。2、一級(jí)菜單最多 4 個(gè)漢字，二級(jí)菜單最多7 個(gè)漢字，多出來(lái)的部分將會(huì)以“. ” 代替。3、創(chuàng)建自定義菜單后，由于微信客戶端緩存，需要24 小時(shí)微信客戶端才會(huì)展現(xiàn)出來(lái)。測(cè)試時(shí)可以嘗試取消關(guān)注公眾賬號(hào)后再次

27、關(guān)注，則可以看到創(chuàng)建后的效果。自定義菜單接口可實(shí)現(xiàn)多種類型按鈕，如下：1、click：點(diǎn)擊推事件用戶點(diǎn)擊 click類型按鈕后，微信服務(wù)器會(huì)通過(guò)消息接口推送消息類型為event 的結(jié)構(gòu)給開(kāi)發(fā)者 （參考消息接口指南），并且?guī)习粹o中開(kāi)發(fā)者填寫(xiě)的key 值，開(kāi)發(fā)者可以通過(guò)自定義的key 值與用戶進(jìn)行交互；2、view ：跳轉(zhuǎn) url用戶點(diǎn)擊 view類型按鈕后，微信客戶端將會(huì)打開(kāi)開(kāi)發(fā)者在按鈕中填寫(xiě)的網(wǎng)頁(yè)url，可與網(wǎng)頁(yè)授權(quán)獲取用戶基本信息接口結(jié)合，獲得用戶基本信息。3、scancode_push：掃碼推事件用戶點(diǎn)擊按鈕后，微信客戶端將調(diào)起掃一掃工具，完成掃碼操作后顯示掃描結(jié)果（如果是url，將進(jìn)入

28、 url），且會(huì)將掃碼的結(jié)果傳給開(kāi)發(fā)者，開(kāi)發(fā)者可以下發(fā)消息。4、scancode_waitmsg：掃碼推事件且彈出 “ 消息接收中 ” 提示框用戶點(diǎn)擊按鈕后，微信客戶端將調(diào)起掃一掃工具，完成掃碼操作后，將掃碼的結(jié)果傳給開(kāi)發(fā)者，同時(shí)收起掃一掃工具，然后彈出 “ 消息接收中 ” 提示框，隨后可能會(huì)收到開(kāi)發(fā)者下發(fā)的消息。5、pic_sysphoto：彈出系統(tǒng)拍照發(fā)圖用戶點(diǎn)擊按鈕后，微信客戶端將調(diào)起系統(tǒng)相機(jī)，完成拍照操作后，會(huì)將拍攝的相片發(fā)送給開(kāi)發(fā)者，并推送事件給開(kāi)發(fā)者，同時(shí)收起系統(tǒng)相機(jī)，隨后可能會(huì)收到開(kāi)發(fā)者下發(fā)的消息。6、pic_photo_or_album：彈出拍照或者相冊(cè)發(fā)圖用戶點(diǎn)擊按鈕后，微信

29、客戶端將彈出選擇器供用戶選擇“ 拍照” 或者“ 從手機(jī)相冊(cè)選擇 ” 。 用戶選擇后即走其他兩種流程。7、pic_weixin：彈出微信相冊(cè)發(fā)圖器用戶點(diǎn)擊按鈕后，微信客戶端將調(diào)起微信相冊(cè)，完成選擇操作后，將選擇的相片發(fā)送給開(kāi)發(fā)者的服務(wù)器，并推送事件給開(kāi)發(fā)者，同時(shí)收起相冊(cè)，隨后可能會(huì)收到開(kāi)發(fā)者下發(fā)的消息。8、location_select：彈出地理位置選擇器用戶點(diǎn)擊按鈕后， 微信客戶端將調(diào)起地理位置選擇工具，完成選擇操作后， 將選擇的地理位置發(fā)送給開(kāi)發(fā)者的服務(wù)器，同時(shí)收起位置選擇工具，隨后可能會(huì)收到開(kāi)發(fā)者下發(fā)的消息。9、media_id：下發(fā)消息（除文本消息）用戶點(diǎn)擊 media_id類型按鈕后，

30、微信服務(wù)器會(huì)將開(kāi)發(fā)者填寫(xiě)的永久素材id 對(duì)應(yīng)的素材下發(fā)給用戶，永久素材類型可以是圖片、音頻、視頻、圖文消息。請(qǐng)注意：永久素材id 必須是在 “ 素材管理 / 新增永久素材 ” 接口上傳后獲得的合法 id 。10、view_limited：跳轉(zhuǎn)圖文消息url用戶點(diǎn)擊 view_limited類型按鈕后，微信客戶端將打開(kāi)開(kāi)發(fā)者在按鈕中填寫(xiě)的永久素材id對(duì)應(yīng)的圖文消息url，永久素材類型只支持圖文消息。請(qǐng)注意：永久素材 id必須是在 “ 素材管理 / 新增永久素材 ” 接口上傳后獲得的合法id 。請(qǐng)注意， 3 到 8 的所有事件，僅支持微信iphone5.4.1以上版本，和 android5.4以上

31、版本的微信用戶，舊版本微信用戶點(diǎn)擊后將沒(méi)有回應(yīng)，開(kāi)發(fā)者也不能正常接收到事件推送。9和 10，是專門(mén)給第三方平臺(tái)旗下未微信認(rèn)證（具體而言，是資質(zhì)認(rèn)證未通過(guò)）的訂閱號(hào)準(zhǔn)備的事件類型，它們是沒(méi)有事件推送的，能力相對(duì)受限，其他類型的公眾號(hào)不必使用。接口調(diào)用請(qǐng)求說(shuō)明http 請(qǐng)求方式： post （請(qǐng)使用 https協(xié)議）https:/ view 的請(qǐng)求示例 button: type:click, name:今日歌曲 , key:v1001_today_music , name:菜單, sub_button: type:view, name:搜索, url:http:/ , type:view, nam

32、e:視頻, url:http:/ , type:click, name:贊一下我們 , key:v1001_good 其他新增按鈕類型的請(qǐng)求示例 button: name: 掃碼 , sub_button: type: scancode_waitmsg, name: 掃碼帶提示 , key: rselfmenu_0_0, sub_button: , type: scancode_push, name: 掃碼推事件 , key: rselfmenu_0_1, sub_button: , name: 發(fā)圖 , sub_button: type: pic_sysphoto, name: 系統(tǒng)拍照發(fā)圖

33、 , key: rselfmenu_1_0, sub_button: , type: pic_photo_or_album, name: 拍照或者相冊(cè)發(fā)圖 , key: rselfmenu_1_1, sub_button: , type: pic_weixin, name: 微信相冊(cè)發(fā)圖 , key: rselfmenu_1_2, sub_button: , name: 發(fā)送位置 , type: location_select, key: rselfmenu_2_0 , type: media_id, name: 圖片, media_id: media_id1 , type: view_lim

34、ited, name: 圖文消息 , media_id: media_id2 參數(shù)說(shuō)明參數(shù)是否必須說(shuō)明button 是一級(jí)菜單數(shù)組，個(gè)數(shù)應(yīng)為13 個(gè)sub_button 否二級(jí)菜單數(shù)組，個(gè)數(shù)應(yīng)為15 個(gè)type 是菜單的響應(yīng)動(dòng)作類型name 是菜單標(biāo)題，不超過(guò)16 個(gè)字節(jié)，子菜單不超過(guò) 40 個(gè)字節(jié)key click等點(diǎn)擊類型必須菜單 key值，用于消息接口推送， 不超過(guò) 128 字節(jié)url view 類型必須網(wǎng)頁(yè)鏈接，用戶點(diǎn)擊菜單可打開(kāi)鏈接，不超過(guò) 256 字節(jié)media_id media_id 類型和 view_limited類型必須調(diào)用新增永久素材接口返回的合法media_id 返回結(jié)果

35、正確時(shí)的返回json 數(shù)據(jù)包如下：errcode:0,errmsg:ok 錯(cuò)誤時(shí)的返回json 數(shù)據(jù)包如下（示例為無(wú)效菜單名長(zhǎng)度）：errcode:40018,errmsg:invalid button name size 全局返回碼說(shuō)明使用網(wǎng)頁(yè)調(diào)試工具調(diào)試該接口2.自定義菜單查詢接口使用接口創(chuàng)建自定義菜單后，開(kāi)發(fā)者還可使用接口查詢自定義菜單的結(jié)構(gòu)。請(qǐng)求說(shuō)明http請(qǐng)求方式： get https:/ 返回結(jié)果 : menu:button:type:click,name:今日歌曲,key:v1001_today_music,sub_button:,type:click,name:歌手簡(jiǎn)介,key

36、:v1001_today_singer,sub_button:,name:菜單,sub_button:type:view,name:搜索,url:http:/ 統(tǒng)一返回碼說(shuō)明使用網(wǎng)頁(yè)調(diào)試工具調(diào)試該接口3 自定義菜單刪除接口使用接口創(chuàng)建自定義菜單后，開(kāi)發(fā)者還可使用接口刪除當(dāng)前使用的自定義菜單。請(qǐng)求說(shuō)明http請(qǐng)求方式： get https:/ 返回結(jié)果 : errcode:0,errmsg:ok 統(tǒng)一返回碼說(shuō)明使用網(wǎng)頁(yè)調(diào)試工具調(diào)試該接口4.自定義菜單事件推送用戶點(diǎn)擊自定義菜單后，微信會(huì)把點(diǎn)擊事件推送給開(kāi)發(fā)者，請(qǐng)注意，點(diǎn)擊菜單彈出子菜單，不會(huì)產(chǎn)生上報(bào)。請(qǐng)注意， 第 3個(gè)到第 8 個(gè)的所有事件，僅支

37、持微信 iphone5.4.1以上版本，和 android5.4以上版本的微信用戶，舊版本微信用戶點(diǎn)擊后將沒(méi)有回應(yīng)，開(kāi)發(fā)者也不能正常接收到事件推送。目錄1點(diǎn)擊菜單拉取消息時(shí)的事件推送2點(diǎn)擊菜單跳轉(zhuǎn)鏈接時(shí)的事件推送3scancode_push：掃碼推事件的事件推送4scancode_waitmsg：掃碼推事件且彈出“消息接收中”提示框的事件推送5pic_sysphoto ：彈出系統(tǒng)拍照發(fā)圖的事件推送6pic_photo_or_album ：彈出拍照或者相冊(cè)發(fā)圖的事件推送7pic_weixin ：彈出微信相冊(cè)發(fā)圖器的事件推送8location_select：彈出地理位置選擇器的事件推送點(diǎn)擊菜單拉取

38、消息時(shí)的事件推送推送 xml數(shù)據(jù)包示例： 123456789 參數(shù)說(shuō)明：參數(shù)描述tousername 開(kāi)發(fā)者 微信號(hào)fromusername 發(fā)送方帳號(hào)（一個(gè)openid）createtime 消息創(chuàng)建時(shí)間（整型）msgtype 消息類型， event event 事件類型， click eventkey 事件 key值，與自定義菜單接口中key值對(duì)應(yīng)點(diǎn)擊菜單跳轉(zhuǎn)鏈接時(shí)的事件推送推送 xml數(shù)據(jù)包示例： 123456789 參數(shù)說(shuō)明：參數(shù)描述tousername 開(kāi)發(fā)者 微信號(hào)fromusername 發(fā)送方帳號(hào)（一個(gè)openid）createtime 消息創(chuàng)建時(shí)間（整型）msgtype 消息

39、類型， event event 事件類型， view eventkey 事件 key值，設(shè)置的跳轉(zhuǎn)url scancode_push：掃碼推事件的事件推送推送 xml數(shù)據(jù)包示例： 1408090502 參數(shù)說(shuō)明：參數(shù)描述tousername 開(kāi)發(fā)者 微信號(hào)fromusername 發(fā)送方帳號(hào)（一個(gè)openid）createtime 消息創(chuàng)建時(shí)間（整型）msgtype 消息類型， event event 事件類型， scancode_push eventkey 事件 key值，由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定scancodeinfo 掃描信息scantype 掃描類型，一般是qrcode scanres

40、ult 掃描結(jié)果，即二維碼對(duì)應(yīng)的字符串信息scancode_waitmsg ：掃碼推事件且彈出“消息接收中”提示框的事件推送推送 xml數(shù)據(jù)包示例： 1408090606 參數(shù)說(shuō)明：參數(shù)描述tousername 開(kāi)發(fā)者 微信號(hào)fromusername 發(fā)送方帳號(hào)（一個(gè)openid）createtime 消息創(chuàng)建時(shí)間（整型）msgtype 消息類型， event event 事件類型， scancode_waitmsg eventkey 事件 key值，由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定scancodeinfo 掃描信息scantype 掃描類型，一般是qrcode scanresult 掃描結(jié)果，即二維

41、碼對(duì)應(yīng)的字符串信息pic_sysphoto：彈出系統(tǒng)拍照發(fā)圖的事件推送推送 xml數(shù)據(jù)包示例： 1408090651 1 參數(shù)說(shuō)明：參數(shù)描述tousername 開(kāi)發(fā)者 微信號(hào)fromusername 發(fā)送方帳號(hào)（一個(gè)openid）createtime 消息創(chuàng)建時(shí)間（整型）msgtype 消息類型， event event 事件類型， pic_sysphoto eventkey 事件 key值，由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定sendpicsinfo 發(fā)送的圖片信息count 發(fā)送的圖片數(shù)量piclist 圖片列表picmd5sum 圖片的 md5值，開(kāi)發(fā)者若需要，可用于驗(yàn)證接收到圖片pic_phot

42、o_or_album：彈出拍照或者相冊(cè)發(fā)圖的事件推送推送 xml數(shù)據(jù)包示例： 1408090816 1 參數(shù)說(shuō)明：參數(shù)描述tousername 開(kāi)發(fā)者 微信號(hào)fromusername 發(fā)送方帳號(hào)（一個(gè)openid）createtime 消息創(chuàng)建時(shí)間（整型）msgtype 消息類型， event event 事件類型， pic_photo_or_album eventkey 事件 key值，由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定sendpicsinfo 發(fā)送的圖片信息count 發(fā)送的圖片數(shù)量piclist 圖片列表picmd5sum 圖片的 md5 值，開(kāi)發(fā)者若需要，可用于驗(yàn)證接收到圖片pic_weixin

43、：彈出微信相冊(cè)發(fā)圖器的事件推送推送 xml數(shù)據(jù)包示例： 1408090816 1 參數(shù)說(shuō)明：參數(shù)描述tousername 開(kāi)發(fā)者 微信號(hào)fromusername 發(fā)送方帳號(hào)（一個(gè)openid）createtime 消息創(chuàng)建時(shí)間（整型）msgtype 消息類型， event event 事件類型， pic_weixin eventkey 事件 key值，由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定sendpicsinfo 發(fā)送的圖片信息count 發(fā)送的圖片數(shù)量piclist 圖片列表picmd5sum 圖片的 md5 值，開(kāi)發(fā)者若需要，可用于驗(yàn)證接收到圖片location_select：彈出地理位置選擇器的事件推

44、送推送 xml數(shù)據(jù)包示例： 1408091189 參數(shù)說(shuō)明：參數(shù)描述tousername 開(kāi)發(fā)者 微信號(hào)fromusername 發(fā)送方帳號(hào)（一個(gè)openid）createtime 消息創(chuàng)建時(shí)間（整型）msgtype 消息類型， event event 事件類型， location_select eventkey 事件 key值，由開(kāi)發(fā)者在創(chuàng)建菜單時(shí)設(shè)定sendlocationinfo 發(fā)送的位置信息location_x x坐標(biāo)信息location_y y坐標(biāo)信息scale 精度，可理解為精度或者比例尺、越精細(xì)的話 scale越高label 地理位置的字符串信息poiname 朋友圈 poi

45、的名字，可能為空5.自定義菜單配置接口本接口將會(huì)提供公眾號(hào)當(dāng)前使用的自定義菜單的配置，如果公眾號(hào)是通過(guò)api 調(diào)用設(shè)置的菜單，則返回菜單的開(kāi)發(fā)配置，而如果公眾號(hào)是在公眾平臺(tái)官網(wǎng)通過(guò)網(wǎng)站功能發(fā)布菜單，則本接口返回運(yùn)營(yíng)者設(shè)置的菜單配置。請(qǐng)注意：1、第三方平臺(tái)開(kāi)發(fā)者可以通過(guò)本接口，在旗下公眾號(hào)將業(yè)務(wù)授權(quán)給你后，立即通過(guò)本接口檢測(cè)公眾號(hào)的自定義菜單配置，并通過(guò)接口再次給公眾號(hào)設(shè)置好自動(dòng)回復(fù)規(guī)則，以提升公眾號(hào)運(yùn)營(yíng)者的業(yè)務(wù)體驗(yàn)。2、本接口與自定義菜單查詢接口的不同之處在于，本接口無(wú)論公眾號(hào)的接口是如何設(shè)置的，都能查詢到接口，而自定義菜單查詢接口則僅能查詢到使用api 設(shè)置的菜單配置。3、認(rèn)證/ 未認(rèn)證的服

46、務(wù)號(hào) / 訂閱號(hào)，以及接口測(cè)試號(hào)，均擁有該接口權(quán)限。4、從第三方平臺(tái)的公眾號(hào)登錄授權(quán)機(jī)制上來(lái)說(shuō)，該接口從屬于消息與菜單權(quán)限集。5、本接口中返回的mediaid均為臨時(shí)素材（通過(guò)素材管理- 獲取臨時(shí)素材接口來(lái)獲取這些素材），每次接口調(diào)用返回的 mediaid都是臨時(shí)的、不同的，在每次接口調(diào)用后3 天有效，若需永久使用該素材，需使用素材管理接口中的永久素材。接口調(diào)用請(qǐng)求說(shuō)明http請(qǐng)求方式 : get （請(qǐng)使用 https協(xié)議）https:/ is_menu_open: 1, selfmenu_info: button: name: button, sub_button: list: type:

47、view, name: view_url, url: http:/ , type: news, name: news, value:kqb_w_tiz-nsdvlotv35psmty8hgbulghedbb9sks-o, news_info: list: title: multi_news, author: jimzheng, digest: text, show_cover: 0, cover_url: http:/ content_url: http:/ source_url: , title: multi_news1, author: jimzheng, digest: multi_ne

48、ws1, show_cover: 1, cover_url: http:/ content_url: http:/ source_url: , type: video, name: video, value: 0/ , type: voice, name: voice, value: ntxe3aghlq4xyha0aqpwiqqbfw9rvtaytlpc1pcqx11qc9ub6ciupfjdkeetjicn , type: text, name: text, value: this is text! , type: img, name: photo, v

49、alue: ax5whs5dsoomjleppavftbuuh7cgxczgfbfjifmbujnqk_iermhy99y5d2cv14rd 如果公眾號(hào)是通過(guò)api 調(diào)用設(shè)置的菜單，自定義菜單配置樣例如下： is_menu_open: 1, selfmenu_info: button: type: click, name: 今日歌曲 , key: v1001_today_music , name: 菜單 , sub_button: list: type: view, name: 搜索, url: http:/ , type: view, name: 視頻, url: http:/ , type

50、: click, name: 贊一下我們 , key: v1001_good 參數(shù)說(shuō)明參數(shù)說(shuō)明is_menu_open 菜單是否開(kāi)啟， 0 代表未開(kāi)啟， 1 代表開(kāi)啟selfmenu_info 菜單信息button 菜單按鈕type 菜單的類型， 公眾平臺(tái)官網(wǎng)上能夠設(shè)置的菜單類型有view（跳轉(zhuǎn)網(wǎng)頁(yè)）、 text （返回文本，下同）、img、photo 、video 、voice 。使用 api 設(shè)置的則有 8 種，詳見(jiàn)自定義菜單創(chuàng)建接口name 菜單名稱value 、url 、 key 等字段對(duì)于不同的菜單類型， value 的值意義不同。官網(wǎng)上設(shè)置的自定義菜單：text: 保存文字到 va

51、lue ； img 、voice ：保存 mediaid 到value ； video ：保存視頻下載鏈接到value ； news：保存圖文消息到 news_info ，同時(shí)保存 mediaid 到 value ；view：保存鏈接到 url 。使用 api 設(shè)置的自定義菜單： click、scancode_push、scancode_waitmsg 、pic_sysphoto 、pic_photo_or_album 、pic_weixin、location_select：保存值到 key；view ：保存鏈接到 url news_info 圖文消息的信息title 圖文消息的標(biāo)題diges

52、t 摘要author 作者show_cover 是否顯示封面， 0 為不顯示， 1 為顯示cover_url 封面圖片的 url content_url 正文的 url source_url 原文的 url ，若置空則無(wú)查看原文入口賬號(hào)管理1 生成帶參數(shù)二維碼為了滿足用戶渠道推廣分析的需要，公眾平臺(tái)提供了生成帶參數(shù)二維碼的接口。使用該接口可以獲得多個(gè)帶不同場(chǎng)景值的二維碼，用戶掃描后，公眾號(hào)可以接收到事件推送。目前有 2 種類型的二維碼：1、臨時(shí)二維碼，是有過(guò)期時(shí)間的，最長(zhǎng)可以設(shè)置為在二維碼生成后的7 天（即 604800 秒）后過(guò)期 ，但能夠生成較多數(shù)量。臨時(shí)二維碼主要用于帳號(hào)綁定等不要求二維

53、碼永久保存的業(yè)務(wù)場(chǎng)景2、永久二維碼，是無(wú)過(guò)期時(shí)間的，但數(shù)量較少（目前為最多10 萬(wàn)個(gè)）。永久二維碼主要用于適用于帳號(hào)綁定、用戶來(lái)源統(tǒng)計(jì)等場(chǎng)景。用戶掃描帶場(chǎng)景值二維碼時(shí)，可能推送以下兩種事件：1.如果用戶還未關(guān)注公眾號(hào)，則用戶可以關(guān)注公眾號(hào)，關(guān)注后微信會(huì)將帶場(chǎng)景值關(guān)注事件推送給開(kāi)發(fā)者。2.如果用戶已經(jīng)關(guān)注公眾號(hào)，在用戶掃描后會(huì)自動(dòng)進(jìn)入會(huì)話，微信也會(huì)將帶場(chǎng)景值掃描事件推送給開(kāi)發(fā)者。獲取帶參數(shù)的二維碼的過(guò)程包括兩步，首先創(chuàng)建二維碼ticket，然后憑借 ticket到指定 url換取二維碼。創(chuàng)建二維碼ticket每次創(chuàng)建二維碼ticket需要提供一個(gè)開(kāi)發(fā)者自行設(shè)定的參數(shù)（scene_id ），分別介

54、紹臨時(shí)二維碼和永久二維碼的創(chuàng)建二維碼ticket過(guò)程。臨時(shí)二維碼請(qǐng)求說(shuō)明http請(qǐng)求方式 : post url: https:/ json post數(shù)據(jù)例子： expire_seconds: 604800, action_name: qr_scene, action_info: scene: scene_id: 123 永久二維碼請(qǐng)求說(shuō)明http請(qǐng)求方式 : post url: https:/ json post數(shù)據(jù)例子： action_name: qr_limit_scene, action_info: scene: scene_id: 123 或者也可以使用以下post數(shù)據(jù)創(chuàng)建字符串形式的

55、二維碼參數(shù)：action_name: qr_limit_str_scene, action_info: scene: scene_str: 123 參數(shù)說(shuō)明參數(shù)說(shuō)明expire_seconds 該二維碼有效時(shí)間，以秒為單位。最大不超過(guò) 604800（即 7天）。action_name 二維碼類型， qr_scene 為臨時(shí) ,qr_limit_scene 為永久,qr_limit_str_scene為永久的字符串參數(shù)值action_info 二維碼詳細(xì)信息scene_id 場(chǎng)景值 id，臨時(shí)二維碼時(shí)為32 位非 0 整型，永久二維碼時(shí)最大值為 100000（目前參數(shù)只支持1-100000 ）s

56、cene_str 場(chǎng)景值 id（字符串形式的id），字符串類型，長(zhǎng)度限制為1到 64，僅永久二維碼支持此字段返回說(shuō)明正確的 json 返回結(jié)果 : ticket:gqh47joaaaaaaaaaasxodhrwoi8vd2vpeglulnfxlmnvbs9xl2taz2z3tvrtnzjxv1brb3zhymjjaaiez23suwmemm3suw=,expire_seconds:60,url:http:/ 參數(shù)說(shuō)明ticket 獲取的二維碼 ticket，憑借此 ticket可以在有效時(shí)間內(nèi)換取二維碼。expire_seconds 該二維碼有效時(shí)間，以秒為單位。最大不超過(guò) 604800（即

57、7天）。url 二維碼圖片解析后的地址， 開(kāi)發(fā)者可根據(jù)該地址自行生成需要的二維碼圖片錯(cuò)誤的 json 返回示例 : errcode:40013,errmsg:invalid appid 全局返回碼說(shuō)明使用網(wǎng)頁(yè)調(diào)試工具調(diào)試該接口通過(guò) ticket換取二維碼獲取二維碼 ticket后，開(kāi)發(fā)者可用ticket換取二維碼圖片。請(qǐng)注意，本接口無(wú)須登錄態(tài)即可調(diào)用。請(qǐng)求說(shuō)明http get 請(qǐng)求（請(qǐng)使用https協(xié)議）https:/ ticket 記得進(jìn)行 urlencode返回說(shuō)明ticket正確情況下， http 返回碼是 200，是一張圖片，可以直接展示或者下載。http 頭（示例）如下：accept

58、-ranges:bytes cache-control:max-age=604800 connection:keep-alive content-length:28026 content-type:image/jpg date:wed, 16 oct 2013 06:37:10 gmt expires:wed, 23 oct 2013 14:37:10 +0800 server:nginx/1.4.1 錯(cuò)誤情況下（如ticket非法）返回 http錯(cuò)誤碼 404。使用網(wǎng)頁(yè)調(diào)試工具調(diào)試該接口2 長(zhǎng)鏈接轉(zhuǎn)短鏈接接口將一條長(zhǎng)鏈接轉(zhuǎn)成短鏈接。主要使用場(chǎng)景：開(kāi)發(fā)者用于生成二維碼的原鏈接（商品、支付二維碼

59、等）太長(zhǎng)導(dǎo)致掃碼速度和成功率下降，將原長(zhǎng)鏈接通過(guò)此接口轉(zhuǎn)成短鏈接再生成二維碼將大大提升掃碼速度和成功率。接口調(diào)用請(qǐng)求說(shuō)明開(kāi)發(fā)者可通過(guò)openid來(lái)獲取用戶基本信息。請(qǐng)使用https 協(xié)議。http請(qǐng)求方式 : post https:/ 參數(shù)說(shuō)明參數(shù)是否必須說(shuō)明access_token 是調(diào)用接口憑證action 是此處填 long2short，代表長(zhǎng)鏈接轉(zhuǎn)短鏈接long_url 是需要轉(zhuǎn)換的長(zhǎng)鏈接， 支持 http:/、 https:/、 weixin:/wxpay 格式的 url 調(diào)用舉例curl -d action:long2short,long_url:http:/ https:/ 返回說(shuō)明正常情況下，微信會(huì)返回下述json 數(shù)據(jù)包