微信开发者接口文档:微信网页开发 / 网页授权 (qq.com)
- 使用cpolar内网穿透将java项目穿透出去(如果是自己上线的网站便不用这样)
- 在微信开发者平台进行信息修改
步骤:左侧栏 -> 设置与开发 -> 开发者工具 -> 公众平台测试账号
(如果你的公众平台是已经认证的企业/单位账号便不需要这样, 直接去看本人开发者中的接口配置,其他后端配置信息可保持一致)
这个位置需要在本地项目中创建接口用于接收get请求
@GetMapping("/wxCheck")
public String wxSignatureCheck (
@RequestParam("signature") String signature,
@RequestParam("timestamp") String timestamp,
@RequestParam("nonce") String nonce,
@RequestParam("echostr") String echostr
){
log.info("收到微信校验请求,echostr: " + echostr);
// 这一步一定要将微信传来的请求原封不动传回去
return echostr;
}
若提示“该链接无法访问”,请检查参数是否填写错误,是否拥有scope参数对应的授权作用域权限。
一定要在用户列表中添加测试帐号
这步是为了让微信确认该接口可以使用。
在下面开发者接口中的网页服务中找到如下内容
将域名修改为自己的api接口域名,注意是域名,而不是接口
编写二维码生成函数
@GetMapping("/wxLogin")
public Result wxLogin(HttpServletResponse response) throws IOException {
// REDIRECT_URI是回调的地址,需要注意转换成UrlEncode格式
String REDIRECT_URI = URLEncoder.encode("http://3accfbdf.r5.cpolar.top/login/wxCallback", "UTF-8");
// 微信公众平台APPID
String APPID = "wxcab81e275e******";
// 构造二维码链接地址
String url = "https://open.weixin.qq.com/connect/oauth2/authorize?appid=" + APPID
+ "&redirect_uri=" + REDIRECT_URI
+ "&response_type=code"
+ "&scope=snsapi_userinfo"
+ "&state=STATE"
+ "#wechat_redirect";
// 生成二维码返还给前端页面
// 这部分其实是为了将一个链接生成二维码,让用户微信扫描后使用
QrCodeUtil.generate(url, 300, 300, "jpg", response.getOutputStream()); // 使用hutools工具生成二维码,具体用法可查阅
log.info("生成二维码了!");
return Result.success();
}
前端此时访问(“/wxLogin”)接口便可以获取到二维码
我的接口定义的是/api/login/wxLogin,这点使用你自己的接口即可
- 编写获取信息函数(通过code换取网页授权access_token)
微信会通过上面的二维码生成函数中的REDIRECT_URI后面定义的(”/login/wxCallback”)接口返回内容,所以接下来定义的接口一定要上面的一致。
@GetMapping("/wxCallback")
public Result wxCallback(String code) {
// 微信公众平台APPID
String APPID = "wxcab81e275e******";
// 微信公众号appsecret
String APPSECRET = "c9f4ce7890bd45335b9fdb37f1ff****";
String tokenUrl = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=" + APPID +
"&secret=" + APPSECRET +
"&code=" + code +
"&grant_type=authorization_code";
log.info(tokenUrl);
// 使用RestTemplate发送http请求
RestTemplate restTemplate = new RestTemplate();
// 发送GET请求
ResponseEntity<String> response = restTemplate.getForEntity(tokenUrl, String.class);
// 从响应中获取数据
String responseData = response.getBody();
log.info("responseData为:" + responseData);
TokenInfo tokenInfo = JSON.parseObject(responseData, TokenInfo.class);
// 拿到token后,通过token去换取个人信息
String userTokenUrl = "https://api.weixin.qq.com/sns/userinfo?access_token=" + tokenInfo.getAccessToken() + // 使用token验证
"&openid=" + tokenInfo.getOpenid() + // 使用openid获取数据
"&lang=zh_CN"; // 定义语言
// 发送GET请求并获取响应
response = restTemplate.getForEntity(userTokenUrl, String.class);
// 从响应中获取数据
responseData = response.getBody();
log.info("个人数据为:" + responseData);
WxUser wxUser = JSON.parseObject(responseData, WxUser.class); // 这里使用的alibaba fastjson可以将类直接转换为json数据
return Result.success(wxUser);
}
此时前端便可以获取到WxUser中的数据;
最后贴一下我的类的内容:
TokenInfo.java:
@Data
public class TokenInfo {
/**
* 微信调用后返回参数
*/
// 网页授权接口调用凭证
private String accessToken;
// access_token接口调用凭证超时时间,单位(秒)
private String expiresIn;
// 用户刷新access_token
private String refreshToken;
// 用户唯一标识
private String openid;
// 用户授权的作用域
private String scope;
}
WxUser.java:
@Data
public class WxUser {
// 用户的唯一标识
private String openid;
// 用户昵称
private String nickname;
// 用户的性别,值为1时是男性,值为2时是女性,值为0时是未知
private Integer sex;
// 语言
private String language;
// 用户个人资料填写的省份
private String province;
// 普通用户个人资料填写的城市
private String city;
// 国家,如中国为CN
private String country;
// 用户头像,最后一个数值代表正方形头像大小(有0、46、64、96、132数值可选,0代表640*640正方形头像),用户没有头像时该项为空。若用户更换头像,原有头像URL将失效。
private String headimgurl;
// 用户特权信息,json 数组,如微信沃卡用户为(chinaunicom)
private String privilege;
// 只有在用户将公众号绑定到微信开放平台账号后,才会出现该字段。
private String unionid;
}