小程序二維碼生成接口API
阿新 • • 發佈:2018-08-25
ber ons 場景 條件 string 開發者 編譯 適用於 page
獲取小程序碼
我們推薦生成並使用小程序碼,它具有更好的辨識度。目前有兩個接口可以生成小程序碼,開發者可以根據自己的需要選擇合適的接口。
接口A: 適用於需要的碼數量較少的業務場景 接口地址:
https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN
獲取 access_token 詳見文檔
POST 參數說明註意:通過該接口生成的小程序碼,永久有效,數量限制見文末說明,請謹慎使用。用戶掃描該碼進入小程序後,將直接進入 path 對應的頁面。
接口B:適用於需要的碼數量極多,或僅臨時使用的業務場景
接口地址:
https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN
獲取 access_token 詳見文檔
註意:通過該接口生成的小程序碼,永久有效,數量暫無限制。用戶掃描該碼進入小程序後,開發者需在對應頁面獲取的碼中 scene 字段的值,再做處理邏輯。使用如下代碼可以獲取到二維碼中的 scene 字段的值。調試階段可以使用開發工具的條件編譯自定義參數 scene=xxxx 進行模擬,開發工具模擬時的 scene 的參數值需要進行 urlencode
- // 這是首頁的 js
- Page({
- onLoad: function(options) {
- // options 中的 scene 需要使用 decodeURIComponent 才能獲取到生成二維碼時傳入的 scene
- var scene = decodeURIComponent(options.scene)
- }
- })
獲取小程序二維碼
接口C:適用於需要的碼數量較少的業務場景
接口地址:
https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode?access_token=ACCESS_TOKEN
獲取 access_token 詳見文檔
註意:通過該接口生成的小程序二維碼,永久有效,數量限制見文末說明,請謹慎使用。用戶掃描該碼進入小程序後,將直接進入 path 對應的頁面。
示例:
{"path": "pages/index?query=1", "width": 430}
註:pages/index 需要在 app.json
的 pages
中定義
Bug & Tip
tip
:通過該接口,僅能生成已發布的小程序的二維碼。tip
:可以在開發者工具預覽時生成開發版的帶參二維碼。tip
:接口A加上接口C,總共生成的碼數量限制為100,000,請謹慎調用。tip
: POST 參數需要轉成 json 字符串,不支持 form 表單提交。tip
: auto_color line_color 參數僅對小程序碼生效。
小程序二維碼生成接口API