微信小程序：获取不限制的小程序码后端Java实现

文档

• 获取不限制的小程序码

看腾讯写的文档，对于不同的程序员来说，可能接收到的信息会不一样，往往需要花很多时间来调试

1、请求参数

根据文档，可以将入参提取为一个简单java类

用到的第三方库：

• lombok
• jackson

package com.demo.utils.wechat.entity;import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;/* 获取不限制的小程序码接口请求参数* https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/qrcode-link/qr-code/getUnlimitedQRCode.html*/
@Data
public class UnlimitedQRCodeParam {/* 默认是主页，页面 page，例如 pages/index/index，* 根路径前不要填加 /，不能携带参数（参数请放在scene字段里），* 如果不填写这个字段，默认跳主页面。*/private String page;/* 最大32个可见字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~，* 其它字符请自行编码为合法字符（因不支持%，中文无法使用 urlencode 处理，请使用其他编码方式）*/private String scene;/* 默认是true，检查page 是否存在，为 true 时 page 必须是已经发布的小程序存在的页面（否则报错）；* 为 false 时允许小程序未发布或者 page 不存在， 但page 有数量上限（60000个）请勿滥用。*/@JsonProperty("check_path")private Boolean checkPath;/* 否	要打开的小程序版本。* 正式版为 "release"，默认* 体验版为 "trial"* 开发版为 "develop"*/@JsonProperty("env_version")private String envVersion;/* 否	默认430，二维码的宽度，单位 px，最小 280px，最大 1280px*/private Integer width;/* 自动配置线条颜色，如果颜色依然是黑色，则说明不建议配置主色调，默认 false*/@JsonProperty("auto_color")private Boolean autoColor;/* 默认是{"r":0,"g":0,"b":0} 。* auto_color 为 false 时生效，使用 rgb 设置颜色* 例如 {"r":"xxx","g":"xxx","b":"xxx"} 十进制表示*/@JsonProperty("line_color")private LineColor lineColor;/* 否	默认是false，是否需要透明底色，为 true 时，生成透明底色的小程序*/@JsonProperty("is_hyaline")private Integer isHyaline;}

package com.demo.utils.wechat.entity;import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;@Data
public class LineColor {@JsonProperty("r")private Integer red;@JsonProperty("g")private Integer green;@JsonProperty("b")private Integer blue;
}

2、发起请求

请求时用 jackson 将参数序列化为json数据

发起请求时需要注意access_token 参数是查询参数形式传递，其他参数以json格式以body体形式传递

完整示例

POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN 
Content-Type: application/json{"page": "pages/index/index","scene": "a=1","check_path": true,"env_version": "release"
} 

3、响应结果

响应结果

package com.demo.utils.wechat.entity;import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.Data;@Data
public class UnlimitedQRCodeResult {@JsonProperty("errcode")private int errCode;@JsonProperty("errmsg")private String errMsg;private String contentType;private String buffer;
}

注意 这里需要注意：

文档上说返回值是json，实际操作下来会发现

• 如果调用成功，会直接返回图片二进制内容
• 如果请求失败，会返回 JSON 格式的数据

所以需要判断返回内容类型，根据contentType判断，

• 成功：如果是application/json就使用jackson解析，抛出异常
• 失败：如果是image/jpeg ，就使用byte[]接收二进制流