# getWXACode ### getWXACode 獲取小程序碼，適用于需要的碼數量較少的業務場景。**通過該接口生成的小程序碼，永久有效，有數量限制**，詳見[獲取二維碼](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"><span class="pln">POST https</span><span class="pun">:</span><span class="com">//api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN</span></code></li></ol> ``` #### 參數 ##### string access\_token [接口調用憑證](/read/wechat-game-api/297.md) ##### string path 掃碼進入的小程序頁面路徑，最大長度 128 字節，不能為空 ##### 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 的合法值** 值說明45029生成碼個數總和到達最大個數限制#### 返回值說明 如果調用成功，會直接返回圖片二進制內容，如果請求失敗，會返回 JSON 格式的數據。 #### 注意 - POST 參數需要轉成 JSON 字符串，不支持 form 表單提交。 - 接口只能生成已發布的小程序的二維碼 - 與 [createWXAQRCode](/read/wechat-game-api/302.md) 總共生成的碼數量限制為 100,000，請謹慎調用。 > 原文: <https://developers.weixin.qq.com/minigame/dev/api/open-api/qr-code/getWXACode.html>