getWXACodeUnlimit · 微信小游戲開發API官方文檔

# getWXACodeUnlimit ### getWXACodeUnlimit 獲取小程序碼，適用于需要的碼數量極多的業務場景。**通過該接口生成的小程序碼，永久有效，數量暫無限制。** 更多用法詳見 [獲取二維碼](https://developers.weixin.qq.com/minigame/dev/tutorial/open-ability/qr-code.html)。 #### 請求地址 ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN</code></li></ol> ``` #### 參數 ##### string access\_token [接口調用憑證](/read/wechat-game-api/297.md) ##### string scene 最大32個可見字符，只支持數字，大小寫英文以及部分特殊字符：`!#$&'()*+,/:;=?@-._~`，其它字符請自行編碼為合法字符（因不支持`%`，中文無法使用 `urlencode` 處理，請使用其他編碼方式） ##### string page 必須是已經發布的小程序存在的頁面（否則報錯），例如 `pages/index/index`, 根路徑前不要填加 `/`,不能攜帶參數（參數請放在scene字段里），如果不填寫這個字段，默認跳主頁面 ##### number width 二維碼的寬度，默認為 430px，最小 280px，最大 1280px ##### boolean auto\_color 自動配置線條顏色，如果顏色依然是黑色，則說明不建議配置主色調，默認 false ##### Object line\_color auto\_color 為 false 時生效，使用 rgb 設置顏色例如 `{"r":"xxx","g":"xxx","b":"xxx"}` 十進制表示，默認全 0 ##### boolean is\_hyaline 是否需要透明底色，為 true 時，生成透明底色的小程序碼，默認 false #### 返回值 ##### Object 返回的 JSON 數據包屬性類型說明支持版本errcodenumber錯誤碼errmsgstring錯誤信息**errcode 的合法值** 值說明45009調用分鐘頻率受限(目前5000次/分鐘，會調整)，如需大量小程序碼，建議預生成。41030所傳page頁面不存在，或者小程序沒有發布#### 返回值說明如果調用成功，會直接返回圖片二進制內容，如果請求失敗，會返回 JSON 格式的數據。 #### 注意 - POST 參數需要轉成 JSON 字符串，不支持 form 表單提交。 - 接口只能生成已發布的小程序的二維碼 - 調用分鐘頻率受限（5000次/分鐘），如需大量小程序碼，建議預生成#### 獲取 scene 值 scene 字段的值會作為 query 參數傳遞給小程序/小游戲。用戶掃描該碼進入小程序/小游戲后，開發者可以獲取到二維碼中的 scene 值，再做處理邏輯。調試階段可以使用開發工具的條件編譯自定義參數 scene=xxxx 進行模擬，開發工具模擬時的 scene 的參數值需要進行 `encodeURIComponent` **小程序** ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">Page({</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> onLoad (query) {</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> // scene 需要使用 decodeURIComponent 才能獲取到生成二維碼時傳入的 scene</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> const scene = decodeURIComponent(query.scene)</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> }</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7">})</code></li> </ol> ``` **小游戲** ``` <pre class="prettyprint"><ol class="linenums"><li class="l"><code class="pcalibre9 pcalibre8 pcalibre7">wx.onShow(function ({query}) {</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7"> // scene 需要使用 decodeURIComponent 才能獲取到生成二維碼時傳入的 scene</code></li> <li class="l"><code class="pcalibre9 pcalibre8 pcalibre7"> const scene = decodeURIComponent(query.scene)</code></li> <li class="l1"><code class="pcalibre9 pcalibre8 pcalibre7">})</code></li> </ol> ``` > 原文: <https://developers.weixin.qq.com/minigame/dev/api/open-api/qr-code/getWXACodeUnlimit.html>