新聞中心
獲取二維碼
通過(guò)后臺(tái)接口可以獲取小程序任意頁(yè)面的二維碼,掃描該二維碼可以直接進(jìn)入小程序?qū)?yīng)的頁(yè)面。目前微信支持兩種二維碼,小程序碼(左),小程序二維碼(右),如下所示:

成都創(chuàng)新互聯(lián)堅(jiān)持“要么做到,要么別承諾”的工作理念,服務(wù)領(lǐng)域包括:成都網(wǎng)站建設(shè)、網(wǎng)站制作、企業(yè)官網(wǎng)、英文網(wǎng)站、手機(jī)端網(wǎng)站、網(wǎng)站推廣等服務(wù),滿(mǎn)足客戶(hù)于互聯(lián)網(wǎng)時(shí)代的博山網(wǎng)站設(shè)計(jì)、移動(dòng)媒體設(shè)計(jì)的需求,幫助企業(yè)找到有效的互聯(lián)網(wǎng)解決方案。努力成為您成熟可靠的網(wǎng)絡(luò)建設(shè)合作伙伴!
可以使用開(kāi)發(fā)工具 1.02.1803130 及以后版本通過(guò)二維碼編譯功能調(diào)試所獲得的二維碼
獲取小程序碼
我們推薦生成并使用小程序碼,它具有更好的辨識(shí)度。目前有兩個(gè)接口可以生成小程序碼,開(kāi)發(fā)者可以根據(jù)自己的需要選擇合適的接口。
接口A: 適用于需要的碼數(shù)量較少的業(yè)務(wù)場(chǎng)景
接口地址:
https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN
獲取 access_token 詳見(jiàn)文檔
POST 參數(shù)說(shuō)明
| 參數(shù) | 類(lèi)型 | 默認(rèn)值 | 說(shuō)明 |
|---|---|---|---|
| path | String | 不能為空,最大長(zhǎng)度 128 字節(jié) | |
| width | Int | 430 | 二維碼的寬度 |
| auto_color | Bool | false | 自動(dòng)配置線(xiàn)條顏色,如果顏色依然是黑色,則說(shuō)明不建議配置主色調(diào) |
| line_color | Object | {"r":"0","g":"0","b":"0"} | auth_color 為 false 時(shí)生效,使用 rgb 設(shè)置顏色 例如 {"r":"xxx","g":"xxx","b":"xxx"} |
注意:通過(guò)該接口生成的小程序碼,永久有效,數(shù)量限制見(jiàn)文末說(shuō)明,請(qǐng)謹(jǐn)慎使用。用戶(hù)掃描該碼進(jìn)入小程序后,將直接進(jìn)入 path 對(duì)應(yīng)的頁(yè)面。
接口B:適用于需要的碼數(shù)量極多,或僅臨時(shí)使用的業(yè)務(wù)場(chǎng)景
接口地址:
https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN
獲取 access_token 詳見(jiàn)文檔
POST 參數(shù)說(shuō)明
| 參數(shù) | 類(lèi)型 | 默認(rèn)值 | 說(shuō)明 |
|---|---|---|---|
| scene | String | 最大32個(gè)可見(jiàn)字符,只支持?jǐn)?shù)字,大小寫(xiě)英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~,其它字符請(qǐng)自行編碼為合法字符(因不支持%,中文無(wú)法使用 urlencode 處理,請(qǐng)使用其他編碼方式) | |
| page | String | 必須是已經(jīng)發(fā)布的小程序頁(yè)面,例如 "pages/index/index" ,如果不填寫(xiě)這個(gè)字段,默認(rèn)跳主頁(yè)面 | |
| width | Int | 430 | 二維碼的寬度 |
| auto_color | Bool | false | 自動(dòng)配置線(xiàn)條顏色,如果顏色依然是黑色,則說(shuō)明不建議配置主色調(diào) |
| line_color | Object | {"r":"0","g":"0","b":"0"} | auto_color 為 false 時(shí)生效,使用 rgb 設(shè)置顏色 例如 {"r":"xxx","g":"xxx","b":"xxx"} |
注意:通過(guò)該接口生成的小程序碼,永久有效,數(shù)量暫無(wú)限制。用戶(hù)掃描該碼進(jìn)入小程序后,開(kāi)發(fā)者需在對(duì)應(yīng)頁(yè)面獲取的碼中 scene 字段的值,再做處理邏輯。使用如下代碼可以獲取到二維碼中的 scene 字段的值。調(diào)試階段可以使用開(kāi)發(fā)工具的條件編譯自定義參數(shù) scene=xxxx 進(jìn)行模擬,開(kāi)發(fā)工具模擬時(shí)的 scene 的參數(shù)值需要進(jìn)行 urlencode
// 這是首頁(yè)的 js
Page({
onLoad: function(options) {
// options 中的 scene 需要使用 decodeURIComponent 才能獲取到生成二維碼時(shí)傳入的 scene
var scene = decodeURIComponent(options.scene)
}
})
獲取小程序二維碼
接口C:適用于需要的碼數(shù)量較少的業(yè)務(wù)場(chǎng)景
接口地址:
https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode?access_token=ACCESS_TOKEN
獲取 access_token 詳見(jiàn)文檔
POST 參數(shù)說(shuō)明
| 參數(shù) | 類(lèi)型 | 默認(rèn)值 | 說(shuō)明 |
|---|---|---|---|
| path | String | 不能為空,最大長(zhǎng)度 128 字節(jié) | |
| width | Int | 430 | 二維碼的寬度 |
注意:通過(guò)該接口生成的小程序二維碼,永久有效,數(shù)量限制見(jiàn)文末說(shuō)明,請(qǐng)謹(jǐn)慎使用。用戶(hù)掃描該碼進(jìn)入小程序后,將直接進(jìn)入 path 對(duì)應(yīng)的頁(yè)面。
示例:
{"path": "pages/index?query=1", "width": 430}
注:pages/index 需要在app.json的 pages 中定義
Bug & Tip
tip:通過(guò)該接口,僅能生成已發(fā)布的小程序的二維碼。tip:可以在開(kāi)發(fā)者工具預(yù)覽時(shí)生成開(kāi)發(fā)版的帶參二維碼。tip:接口A加上接口C,總共生成的碼數(shù)量限制為100,000,請(qǐng)謹(jǐn)慎調(diào)用。tip: POST 參數(shù)需要轉(zhuǎn)成 json 字符串,不支持 form 表單提交。tip: auto_color line_color 參數(shù)僅對(duì)小程序碼生效。
錯(cuò)誤碼
45009:B接口調(diào)用分鐘頻率受限(目前5000次/分鐘,會(huì)調(diào)整),如需大量小程序碼,建議預(yù)生成。
45029:A接口和C接口生成碼個(gè)數(shù)總和到達(dá)最大個(gè)數(shù)限制。
41030:B接口所傳page頁(yè)面不存在,或者小程序沒(méi)有發(fā)布,請(qǐng)注意B接口沒(méi)有path參數(shù),傳path參數(shù)雖然可以生成小程序碼,但是只能跳主頁(yè)面。
新聞名稱(chēng):創(chuàng)新互聯(lián)小程序教程:微信小程序API獲取小程序頁(yè)面二維碼
URL標(biāo)題:http://fisionsoft.com.cn/article/dhppggg.html


咨詢(xún)
建站咨詢(xún)
