微信掃一掃 掃普通連接二維碼打開微信小程序

掃普通連接二維碼打開小程序

爲了方便小程序開發者更便捷地推廣小程序，兼容線下已有的二維碼，微信公衆平臺開放掃描普通連接二維碼跳轉小程序能力。

功能介紹

普通連接二維碼，是指開發者使用工具對網頁連接進行編碼後生成的二維碼。

線下商戶可不需更換線下二維碼，在小程序後臺完成配置後，便可在用戶掃描普通連接二維碼時打開小程序，使用小程序的功能。

對於普通連接二維碼，目前支持使用微信「掃一掃」或微信內長按識別二維碼跳轉小程序。

開放範圍

企業、媒體、政府及其餘組織類型小程序。

二維碼跳轉規則

注意：從2017年5月開始，微信客戶端支持二維碼規則根據「子路徑匹配」。如原有二維碼連接爲 http://www.qq.com/a/123456 ，其中12345爲業務參數，則可配置規則 http://www.qq.com/a/ 實現掃碼打開小程序。

微信客戶端掃碼將按如下匹配規則控制跳轉：

1. 二維碼連接的協議、域名與已配置的二維碼規則一致。
2. 二維碼連接屬於後臺配置的二維碼規則的子路徑。（如需支持子路徑匹配，請確認後臺配置的二維碼規則以/結尾）
3. 若是二維碼規則包含參數，連接?後爲參數部分，參數要求前綴匹配。

常見匹配錯誤類型：

後臺已配置的二維碼規則	線下二維碼完整連接	錯誤緣由
http://www.qq.com/a/b	https://www.qq.com/a/b	協議不一致
https://www.qq.com/a/b	https://www.weixin.qq.com/a/b	域名不一
https://www.qq.com/a/b?id=123	https://www.qq.com/a/b?id=132	參數不知足前綴匹配
https://www.qq.com/a/b	https://www.qq.com/a/bc	不屬於子路徑
https://www.qq.com/a/b	https://www.qq.com/a/b/123	規則沒有以/結尾，不支持子路徑匹配

二維碼內容獲取

在小程序後臺配置二維碼跳轉小程序規則以後便可使用微信（6.5.6及其以上客戶端版本）掃碼打開小程序。

二維碼連接內容會以參數q的形式帶給頁面，在onLoad事件中提取q參數並自行decodeURIComponent一次，便可獲取原二維碼的完整內容。

配置流程

登陸小程序後臺，進入「設置-開發設置-掃普通連接二維碼打開小程序」，開啓功能後便可配置二維碼規則。

二維碼規則

根據二維碼跳轉規則，開發者須要填寫須要跳轉小程序的二維碼規則。要求以下：

1. 二維碼規則的域名須經過ICP備案的驗證。

2. 支持http、https、ftp開頭的連接（如：http://wx.qq.com、https://wx.qq.com/mp/、https://wx.qq.com/mp?id=123）。

3. 一個小程序賬號可配置很少於10個二維碼前綴規則。

前綴佔用規則

開發者可選擇是否佔用符合二維碼匹配規則的全部子規則。如選擇佔用，則其餘賬號不可申請使用知足該前綴匹配規則的其餘子規則。

如：若開發者A配置二維碼規則：https://wx.qq.com/mp?id=123，並選擇「佔用全部子規則「，其餘開發者將不能夠配置知足前綴匹配的子規則如https://wx.qq.com/mp?id=1234。

如提示「此規則已被佔用」，請聯繫對應小程序開發者溝通解決。

校驗文件

下載隨機校驗文件，並將文件上傳至服務器指定位置的目錄下，方可經過所屬權校驗。

驗證文件放置規則： 放置於URL中聲明的最後一級子目錄下，若無子目錄，則放置於host所屬服務器的頂層目錄下。請根據頁面提示將驗證文件放置在指定的目錄下。

小程序功能頁面

配置掃描二維碼後打開的小程序功能頁面路徑，如：pages/index/index。

測試調試

開發者可對已配置的二維碼規則進行測試和調試。

測試僅對指定的測試連接和測試範圍內的微信用戶生效，其餘用戶掃碼後跳轉網頁，不影響全網用戶正常使用。在二維碼規則發佈後，開發者仍然能夠選擇在指定版本（開發版/體驗版/線上版本）下測試，請注意掃碼用戶要打開開發版必須提交過代碼。

測試範圍

開發者可根據開發進度選擇在開發板/體驗版/線上版本測試「普通二維碼跳轉小程序」的功能。

測試連接

填寫符合二維碼前綴匹配規則的二維碼完整連接用於測試，如包括參數，請完整填寫。

一個規則能夠填寫很少於5個測試連接，可屢次修改。若二維碼與測試連接匹配，且用戶微信號是小程序指定的管理員/開發者/體驗者，將打開指定版本的小程序。

發佈

測試完成後開發者可將二維碼跳轉規則發佈現網，發佈後掃描全部符合匹配規則的二維碼，將跳轉至指定的小程序頁面。

爲確保用戶體驗，小程序必須先發布代碼才能夠發佈二維碼跳轉規則。

一個小程序賬號一個月可發佈很少於20次二維碼跳轉規則。