# 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>