目錄
1何鸡、注冊(cè)微信開(kāi)發(fā)平臺(tái)
2、微信開(kāi)發(fā)平臺(tái)添加網(wǎng)站應(yīng)用
3牛欢、PC微信登錄流程介紹
4骡男、獲取用戶基本信息(UnionID機(jī)制)
1、注冊(cè)微信開(kāi)發(fā)平臺(tái)
官網(wǎng)網(wǎng)址 自行注冊(cè)傍睹，需要注意的是注冊(cè)郵箱號(hào)不用與騰訊其他產(chǎn)品同號(hào)隔盛。
2、微信開(kāi)發(fā)平臺(tái)添加網(wǎng)站應(yīng)用
以上資料提交之后等待TX審核拾稳，審核時(shí)間大概2天左右吮炕，審核通過(guò)之后就可以查看AppID AppSecret以及申請(qǐng)微信登錄。
注意：如果注冊(cè)完的開(kāi)放平臺(tái)之后有進(jìn)行開(kāi)發(fā)者認(rèn)證時(shí)访得，審核通過(guò)之后微信登錄默認(rèn)是開(kāi)通的龙亲，如果沒(méi)有進(jìn)行開(kāi)發(fā)者認(rèn)證點(diǎn)擊申請(qǐng)開(kāi)通 時(shí)會(huì)提醒進(jìn)行開(kāi)發(fā)者認(rèn)證(如下圖)
3悍抑、PC微信登錄流程介紹
網(wǎng)站應(yīng)用微信登錄是基于OAuth2.0協(xié)議標(biāo)準(zhǔn)構(gòu)建的微信OAuth2.0授權(quán)登錄系統(tǒng)鳄炉。進(jìn)一步了解OAuth2.0-----理解OAuth2.0 官方介紹資料
大致的步驟如下：
- 第三方發(fā)起微信授權(quán)登錄請(qǐng)求，微信用戶允許授權(quán)第三方應(yīng)用后搜骡，微信會(huì)拉起應(yīng)用或重定向到第三方網(wǎng)站拂盯，并且?guī)鲜跈?quán)臨時(shí)票據(jù)code參數(shù)；
- 通過(guò)code參數(shù)加上AppID和AppSecret等浆兰，通過(guò)API換取access_token磕仅；
- 通過(guò)access_token進(jìn)行接口調(diào)用，獲取用戶基本數(shù)據(jù)資源或幫助用戶實(shí)現(xiàn)基本操作簸呈。
具體的步驟如下：
第一步：請(qǐng)求CODE
接口說(shuō)明
https://open.weixin.qq.com/connect/qrconnect?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect
參數(shù)說(shuō)明
| 參數(shù) | 是否必須 | 說(shuō)明 |
|---|---|---|
| appid | 是 | 應(yīng)用唯一標(biāo)識(shí) |
| redirect_uri | 是 | 重定向地址榕订，需要進(jìn)行UrlEncode |
| response_type | 是 | 填code |
| scope | 是 | 應(yīng)用授權(quán)作用域，擁有多個(gè)作用域用逗號(hào)（,）分隔蜕便，網(wǎng)頁(yè)應(yīng)用目前僅填寫snsapi_login即可 |
| state | 否 | 用于保持請(qǐng)求和回調(diào)的狀態(tài)劫恒，授權(quán)請(qǐng)求后原樣帶回給第三方。該參數(shù)可用于防止csrf攻擊（跨站請(qǐng)求偽造攻擊）轿腺，建議第三方帶上該參數(shù)两嘴，可設(shè)置為簡(jiǎn)單的隨機(jī)數(shù)加session進(jìn)行校驗(yàn) |
若提示“該鏈接無(wú)法訪問(wèn)”，請(qǐng)檢查參數(shù)是否填寫錯(cuò)誤族壳，如redirect_uri的域名與審核時(shí)填寫的授權(quán)域名不一致或scope不為snsapi_login憔辫。
返回說(shuō)明
用戶允許授權(quán)后，將會(huì)重定向到redirect_uri的網(wǎng)址上仿荆，并且?guī)蟘ode和state參數(shù)
redirect_uri?code=CODE&state=STATE
若用戶禁止授權(quán)贰您，則重定向后不會(huì)帶上code參數(shù)坏平，僅會(huì)帶上state參數(shù)
redirect_uri?state=STATE
接口封裝
private static String qrconnect_url = "https://open.weixin.qq.com/connect/qrconnect";
/**
* 生成網(wǎng)頁(yè)二維碼授權(quán)鏈接
* @param appId 應(yīng)用id
* @param redirect_uri 回跳地址
* @return url
*/
public static String getQrConnectURL(String appId, String redirect_uri) {
return getQrConnectURL(appId, redirect_uri, null);
}
/**
* 生成網(wǎng)頁(yè)二維碼授權(quán)鏈接
* @param appId 應(yīng)用id
* @param redirect_uri 回跳地址
* @param state 重定向后會(huì)帶上state參數(shù)，開(kāi)發(fā)者可以填寫a-zA-Z0-9的參數(shù)值锦亦，最多128字節(jié)
* @return url
*/
public static String getQrConnectURL(String appId, String redirect_uri, String state) {
Map<String, String> params = new HashMap<String, String>();
params.put("appid", appId);
params.put("response_type", "code");
params.put("redirect_uri", redirect_uri);
params.put("scope", "snsapi_login");
if (StrKit.isBlank(state)) {
params.put("state", "wx#wechat_redirect");
} else {
params.put("state", state.concat("#wechat_redirect"));
}
String para = PaymentKit.packageSign(params, false);
return qrconnect_url + "?" + para;
}
接口測(cè)試
1舶替、設(shè)置AppId、APPSecret以及回調(diào)域名
2杠园、PC訪問(wèn)測(cè)試顾瞪。開(kāi)源項(xiàng)目中訪問(wèn)地址為：
http://域名/[項(xiàng)目名稱]/toWebOauth
//pc掃描登陸
public void toWebOauth(){
String calbackUrl=PropKit.get("domain")+"/oauth/webCallBack";
String url=SnsAccessTokenApi.getQrConnectURL(PropKit.get("webAppId"), calbackUrl,"666");
redirect(url);
}
如果授權(quán)回調(diào)域名與開(kāi)發(fā)平臺(tái)中的填寫不一致將會(huì)出現(xiàn)以下提示
第二步：通過(guò)code獲取access_token
第三步：通過(guò)access_token調(diào)用接口獲取用戶信息
第二步抛蚁、第三步過(guò)程與微信公眾號(hào)授權(quán)登錄一樣可以參考之前寫的一篇文章授權(quán)獲取用戶信息
授權(quán)后接口調(diào)用（UnionID）
獲取用戶個(gè)人信息（UnionID機(jī)制）
此接口用于獲取用戶個(gè)人信息陈醒。開(kāi)發(fā)者可通過(guò)OpenID來(lái)獲取用戶基本信息。特別需要注意的是篮绿，如果開(kāi)發(fā)者擁有多個(gè)移動(dòng)應(yīng)用孵延、網(wǎng)站應(yīng)用和公眾帳號(hào)，可通過(guò)獲取用戶基本信息中的unionid來(lái)區(qū)分用戶的唯一性亲配，因?yàn)橹灰峭粋€(gè)微信開(kāi)放平臺(tái)帳號(hào)下的移動(dòng)應(yīng)用尘应、網(wǎng)站應(yīng)用和公眾帳號(hào)，用戶的unionid是唯一的吼虎。換句話說(shuō)犬钢，同一用戶，對(duì)同一個(gè)微信開(kāi)放平臺(tái)下的不同應(yīng)用思灰，unionid是相同的玷犹。請(qǐng)注意，在用戶修改微信頭像后洒疚，舊的微信頭像URL將會(huì)失效歹颓，因此開(kāi)發(fā)者應(yīng)該自己在獲取用戶信息后，將頭像圖片保存下來(lái)油湖，避免微信頭像URL失效后的異常情況巍扛。
接口封裝可以參考開(kāi)源項(xiàng)目中
網(wǎng)頁(yè)授權(quán)（公眾號(hào)、PC）獲取用戶信息
import com.jfinal.kit.StrKit;
import com.jfinal.weixin.sdk.kit.ParaMap;
import com.jfinal.weixin.sdk.kit.PaymentKit;
import com.jfinal.weixin.sdk.utils.HttpUtils;
import com.jfinal.weixin.sdk.utils.RetryUtils;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.Callable;
public class SnsAccessTokenApi
{
private static String url = "https://api.weixin.qq.com/sns/oauth2/access_token?grant_type=authorization_code";
private static String authorize_uri = "https://open.weixin.qq.com/connect/oauth2/authorize";
private static String qrconnect_url = "https://open.weixin.qq.com/connect/qrconnect";
/**
* 生成Authorize鏈接
* @param appId 應(yīng)用id
* @param redirect_uri 回跳地址
* @param snsapiBase snsapi_base（不彈出授權(quán)頁(yè)面乏德，只能拿到用戶openid）snsapi_userinfo（彈出授權(quán)頁(yè)面撤奸，這個(gè)可以通過(guò) openid 拿到昵稱、性別喊括、所在地）
* @return url
*/
public static String getAuthorizeURL(String appId, String redirect_uri, boolean snsapiBase) {
return getAuthorizeURL(appId, redirect_uri, null, snsapiBase);
}
/**
* 生成Authorize鏈接
* @param appId 應(yīng)用id
* @param redirectUri 回跳地址
* @param state 重定向后會(huì)帶上state參數(shù)胧瓜，開(kāi)發(fā)者可以填寫a-zA-Z0-9的參數(shù)值，最多128字節(jié)
* @param snsapiBase snsapi_base（不彈出授權(quán)頁(yè)面郑什，只能拿到用戶openid）snsapi_userinfo（彈出授權(quán)頁(yè)面府喳，這個(gè)可以通過(guò) openid 拿到昵稱、性別蘑拯、所在地）
* @return url
*/
public static String getAuthorizeURL(String appId, String redirectUri, String state, boolean snsapiBase) {
Map<String, String> params = new HashMap<String, String>();
params.put("appid", appId);
params.put("response_type", "code");
params.put("redirect_uri", redirectUri);
// snsapi_base（不彈出授權(quán)頁(yè)面劫拢，只能拿到用戶openid）
// snsapi_userinfo（彈出授權(quán)頁(yè)面肉津，這個(gè)可以通過(guò) openid 拿到昵稱、性別舱沧、所在地）
if (snsapiBase) {
params.put("scope", "snsapi_base");
} else {
params.put("scope", "snsapi_userinfo");
}
if (StrKit.isBlank(state)) {
params.put("state", "wx#wechat_redirect");
} else {
params.put("state", state.concat("#wechat_redirect"));
}
String para = PaymentKit.packageSign(params, false);
return authorize_uri + "?" + para;
}
/**
* 生成網(wǎng)頁(yè)二維碼授權(quán)鏈接
* @param appId 應(yīng)用id
* @param redirect_uri 回跳地址
* @return url
*/
public static String getQrConnectURL(String appId, String redirect_uri) {
return getQrConnectURL(appId, redirect_uri, null);
}
/**
* 生成網(wǎng)頁(yè)二維碼授權(quán)鏈接
* @param appId 應(yīng)用id
* @param redirect_uri 回跳地址
* @param state 重定向后會(huì)帶上state參數(shù)，開(kāi)發(fā)者可以填寫a-zA-Z0-9的參數(shù)值偶洋，最多128字節(jié)
* @return url
*/
public static String getQrConnectURL(String appId, String redirect_uri, String state) {
Map<String, String> params = new HashMap<String, String>();
params.put("appid", appId);
params.put("response_type", "code");
params.put("redirect_uri", redirect_uri);
params.put("scope", "snsapi_login");
if (StrKit.isBlank(state)) {
params.put("state", "wx#wechat_redirect");
} else {
params.put("state", state.concat("#wechat_redirect"));
}
String para = PaymentKit.packageSign(params, false);
return qrconnect_url + "?" + para;
}
/**
* 通過(guò)code獲取access_token
*
* @param code 第一步獲取的code參數(shù)
* @param appId 應(yīng)用唯一標(biāo)識(shí)
* @param secret 應(yīng)用密鑰AppSecret
* @return SnsAccessToken
*/
public static SnsAccessToken getSnsAccessToken(String appId, String secret, String code)
{
final Map<String, String> queryParas = ParaMap.create("appid", appId).put("secret", secret).put("code", code).getData();
return RetryUtils.retryOnException(3, new Callable<SnsAccessToken>() {
@Override
public SnsAccessToken call() throws Exception {
String json = HttpUtils.get(url, queryParas);
return new SnsAccessToken(json);
}
});
}
}
用戶管理接口,獲取用戶基本信息(UnionID機(jī)制)
import com.jfinal.weixin.sdk.kit.ParaMap;
import com.jfinal.weixin.sdk.utils.HttpUtils;
import com.jfinal.weixin.sdk.utils.JsonUtils;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
* 用戶管理 API
* <pre>
* https://api.weixin.qq.com/cgi-bin/user/info?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN
* </pre>
*/
public class UserApi {
private static String getUserInfo = "https://api.weixin.qq.com/cgi-bin/user/info";
private static String getFollowers = "https://api.weixin.qq.com/cgi-bin/user/get";
private static String batchGetUserInfo = "https://api.weixin.qq.com/cgi-bin/user/info/batchget?access_token=";
/**
* 獲取用戶基本信息（包括UnionID機(jī)制）
* @param openId 普通用戶的標(biāo)識(shí)熟吏，對(duì)當(dāng)前公眾號(hào)唯一
* @return ApiResult
*/
public static ApiResult getUserInfo(String openId) {
ParaMap pm = ParaMap.create("access_token", AccessTokenApi.getAccessTokenStr()).put("openid", openId).put("lang", "zh_CN");
return new ApiResult(HttpUtils.get(getUserInfo, pm.getData()));
}
/**
* 獲取用戶列表
* @param nextOpenid 第一個(gè)拉取的OPENID，不填默認(rèn)從頭開(kāi)始拉取
* @return ApiResult
*/
public static ApiResult getFollowers(String nextOpenid) {
ParaMap pm = ParaMap.create("access_token", AccessTokenApi.getAccessTokenStr());
if (nextOpenid != null)
pm.put("next_openid", nextOpenid);
return new ApiResult(HttpUtils.get(getFollowers, pm.getData()));
}
/**
* 獲取用戶列表
* @return ApiResult
*/
public static ApiResult getFollows() {
return getFollowers(null);
}
/**
* 批量獲取用戶基本信息, by Unas
* @param jsonStr json字符串
* @return ApiResult
*/
public static ApiResult batchGetUserInfo(String jsonStr) {
String jsonResult = HttpUtils.post(batchGetUserInfo + AccessTokenApi.getAccessTokenStr(), jsonStr);
return new ApiResult(jsonResult);
}
/**
* 批量獲取用戶基本信息
* @param openIdList openid列表
* @return ApiResult
*/
public static ApiResult batchGetUserInfo(List<String> openIdList) {
Map<String, List<Map<String, Object>>> userListMap = new HashMap<String, List<Map<String, Object>>>();
List<Map<String, Object>> userList = new ArrayList<Map<String,Object>>();
for (String openId : openIdList) {
Map<String, Object> mapData = new HashMap<String, Object>();
mapData.put("openid", openId);
mapData.put("lang", "zh_CN");
userList.add(mapData);
}
userListMap.put("user_list", userList);
return batchGetUserInfo(JsonUtils.toJson(userListMap));
}
private static String updateRemarkUrl = "https://api.weixin.qq.com/cgi-bin/user/info/updateremark?access_token=";
/**
* 設(shè)置備注名
* @param openid 用戶標(biāo)識(shí)
* @param remark 新的備注名玄窝，長(zhǎng)度必須小于30字符
* @return {ApiResult}
*/
public static ApiResult updateRemark(String openid, String remark) {
String url = updateRemarkUrl + AccessTokenApi.getAccessTokenStr();
Map<String, String> mapData = new HashMap<String, String>();
mapData.put("openid", openid);
mapData.put("remark", remark);
String jsonResult = HttpUtils.post(url, JsonUtils.toJson(mapData));
return new ApiResult(jsonResult);
}
}
推薦閱讀
Android版-微信APP支付
極速開(kāi)發(fā)微信公眾號(hào)之微信買單
極速開(kāi)發(fā)微信公眾號(hào)之公眾號(hào)支付
極速開(kāi)發(fā)微信公眾號(hào)之掃碼支付
極速開(kāi)發(fā)微信公眾號(hào)之刷卡支付
極速開(kāi)發(fā)微信公眾號(hào)之現(xiàn)金紅包
Android版-支付寶APP支付
支付寶Wap支付
一張二維碼集成微信牵寺、支付寶支付
源碼下載地址
記錄學(xué)習(xí)的點(diǎn)滴，以此勉勵(lì)不斷奮斗的自己?????? 如果對(duì)你有幫助記得點(diǎn)喜歡告訴我
