功能说明:在snsapi_base作用域下,通过code获取openid
配置文件
# 文件配置参数
wechat:
#公众号对应的appid
app-id: wxac7fda1f31abb799
#公众号对应的appsecret
app-secret: 3a713a6c29e869e13d38383e2e69b99c
工具类直接调用
public class WechatUtil {
private static final String HTTP_URL="https://api.weixin.qq.com/sns/oauth2/access_token";
/**在snsapi_base作用域下
* @param code
* @return opneid
*/
public static Map<String,String> getWxToken(String code) {
// Spring封装好的http请求工具类
Map hashMap = null;
try {
RestTemplate restTemplate = new RestTemplate();
// http Header参数
MultiValueMap<String, String> header = new LinkedMultiValueMap();
header.add("Content-Type", "application/x-www-form-urlencoded");
header.add("Accept", "*/*");
MultiValueMap<String, Object> map = new LinkedMultiValueMap();
// 请求入参 (同请求地址)
map.add("appid", AppConfigure.getProperty("wechat.app-id"));
map.add("secret", AppConfigure.getProperty("wechat.app-secret"));
map.add("code", code);
// 固定参数 无需改变
map.add("grant_type", "authorization_code");
HttpEntity<MultiValueMap<String, Object>> httpEntity = new HttpEntity<>(map, header);
// 发送请求,固定写法
ResponseEntity<String> response = restTemplate.exchange(HTTP_URL, HttpMethod.POST, httpEntity, String.class);
hashMap = JSON.parseObject(response.getBody(), HashMap.class);
log.info(response.getBody());
} catch (RestClientException e) {
log.error(e.getMessage());
return null;
}
return hashMap;
}
}
对接公众号详细过程 概括来说整个流程就是请求微信授权接口,授权成功后跳转到回调地址中,在回调地址页面中写我们自己的业务逻辑
1、公众号管理后台网页端操作
- 访问 微信公众平台 使用公众号管理员账号登录
- 登录后,设置与开发-接口权限,确认已获得网页授权权限
- 点击设置与开发-基本配置,查看公众号的appid和appsecret(若未获取appsecret,需要先获取)
- 点击设置与开发-开发者工具-web开发者工具-绑定开发者微信号,绑定具体开发人员的微信号,用于后续的开发、测试
- 点击设置与开发-公众号设置-功能设置,设置业务域名等,这个域名就是提供回调地址的域名,设置时根据弹窗提示内容操作即可,需要注意的是域名设置每月有次数上限,不要胡乱设置
2、代码端操作
- 需要引导用户打开 https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect
- 其中appid是公众号的唯一标识;
- redirect_uri是授权后重定向的回调链接地址,授权成功后会自动在回调地址后边携带code参数,前端要做的就是获取url中的code参数传递至后端,后端用code置换获取到openid;
- response_type返回类型,请填写code;
- scope是应用授权作用域,snsapi_base(不弹出授权页面,直接跳转,只能获取用户openid),snsapi_userinfo (弹出授权页面,可通过openid拿到昵称、性别、所在地。并且, 即使在未关注的情况下,只要用户授权,也能获取其信息 );
- state,非必填参数,重定向后会带上state参数,开发者可以填写a-zA-Z0-9的参数值,最多128字节
- wechat_redirect,无论直接打开还是做页面302重定向时候,必须带此参数
- 获取到code后(每次用户授权带上的code不一样,code只能使用一次,5分钟未被使用自动过期),前端将code作为参数传递至后端调用WechatUtil.getWxToken()方法,获取openid(用户唯一标识)
- 获取的openid即可作为唯一用户标识参与接下来的业务逻辑
3、测试操作
- 测试须用微信开发者工具,下载地址https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html(稳定版)
- 用开发者微信号扫码登录后,点击公众号网页项目
- 地址栏中输入https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect即可访问
- 微信公众号菜单设置时,菜单地址即为https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect