📝 更新文档

🔖 发布一个版本, 1.15.1，1.15.0版有问题，请不要使用。抱歉
🔖 发布一个版本, 1.15.0
2026-05-22 13:43:20 +00:00 · 2020-04-10 16:02:29 +08:00 · 2020-04-10 15:53:14 +08:00 · 2020-04-10 15:46:29 +08:00 · 2020-04-10 15:45:27 +08:00 · 2020-04-10 15:18:19 +08:00
183 changed files with 5928 additions and 1888 deletions
@@ -1,15 +1,15 @@
-[ ] 是否为解决Issue？
+- [ ] 是否为解决Issue？


 ### 您做了哪些更新？

-#### 新增
+- 新增

-#### 修改
+- 修改

-#### 修复
+- 修复

-#### 其他
+- 其他


 ### 是否做了充分测试？
@@ -18,9 +18,12 @@
 - [ ] 否，还没做测试，需要作者自测

 注：测试demo可以使用：
- [Springboot版](https://gitee.com/yadong.zhang/JustAuth-demo)
+- [simple版](https://github.com/justauth/JustAuth-demo)
 - [jFinal版](https://github.com/xkcoding/jfinal-justauth-demo)
 - [ActFramework版](https://github.com/xkcoding/act-justauth-demo)
+- [Nutzboot版](https://github.com/EggsBlue/nutzboot-justauth-demo)
+- [Blade版](https://github.com/justauth/blade-justauth-demo)
+



@@ -25,6 +25,12 @@ hs_err_pid*
 # exclude idea files
 .idea
 *.iml
-*.sh
+bin/codecov.sh
+bin/deploy.sh
+bin/docsify-cli.sh
+bin/push.sh
+bin/push-dev.sh

-target
+target
+/pom.xml.versionsBackup
+/gpg
@@ -1,12 +1,12 @@
 <p align="center">
-	<a href="https://www.justauth.cn/"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/logo.png" width="400"></a>
+	<a href="https://docs.justauth.whnb.wang"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/Justauth.png" width="400"></a>
 </p>
 <p align="center">
 	<strong>Login, so easy.</strong>
 </p>
 <p align="center">
 	<a target="_blank" href="https://search.maven.org/search?q=JustAuth">
-		<img src="https://img.shields.io/badge/Maven Central-1.11.0-blue.svg" ></img>
+		<img src="https://img.shields.io/badge/Maven%20Central--1.15.1-blue" ></img>
 	</a>
 	<a target="_blank" href="https://gitee.com/yadong.zhang/JustAuth/blob/master/LICENSE">
 		<img src="https://img.shields.io/apm/l/vim-mode.svg?color=yellow" ></img>
@@ -15,7 +15,7 @@
 		<img src="https://img.shields.io/badge/JDK-1.8+-green.svg" ></img>
 	</a>
 	<a target="_blank" href="https://apidoc.gitee.com/yadong.zhang/JustAuth/" title="API文档">
-		<img src="https://img.shields.io/badge/Api Docs-1.11.0-orange.svg" ></img>
+		<img src="https://img.shields.io/badge/Api%20Docs--1.15.1-latest-orange" ></img>
 	</a>
 	<a target="_blank" href="https://docs.justauth.whnb.wang" title="参考文档">
 		<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
@@ -44,7 +44,7 @@
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/oschina.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/alipay.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/qq.png" width="20"></td>
-            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20"></td>
+            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20" title="微信开放平台"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/taobao.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/google.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/facebook.png" width="20"></td>
@@ -66,8 +66,12 @@
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/csdn.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/kujiale.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitlab.png" width="20"></td>
+            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/meituan.png" width="20"></td>
+            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/eleme.png" width="20"></td>
+            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20"></td>
        </tr>
    </table>
+    <center><a href="https://docs.justauth.whnb.wang/#/?id=%E5%B7%B2%E9%9B%86%E6%88%90%E7%9A%84%E5%B9%B3%E5%8F%B0" target="_blank">查看更多</a></center>
 </center>

 -------------------------------------------------------------------------------
@@ -81,7 +85,7 @@ Docs：[Reference Doc](https://docs.justauth.whnb.wang)

 ## Features

-1. **Multiple platform**: Has integrated more than a dozen third-party platforms.
+1. **Multiple platform**: Has integrated more than a dozen third-party platforms.([plan](https://gitee.com/yadong.zhang/JustAuth/issues/IUGRK))
 2. **Minimalist**: The minimalist design is very simple to use.

 ## Quick start
@@ -93,7 +97,7 @@ These artifacts are available from Maven Central:
 <dependency>
    <groupId>me.zhyd.oauth</groupId>
    <artifactId>JustAuth</artifactId>
-    <version>${latest.version}</version>
+    <version>1.15.1</version>
 </dependency>
 ```
 - Using JustAuth
@@ -111,21 +115,58 @@ authRequest.authorize("state");
 authRequest.login(callback);
 ```

+Note, that since [v1.14.0](https://gitee.com/yadong.zhang/JustAuth/releases/v1.14.0) JustAuth has been integrated by default with [simple-http](https://github.com/xkcoding/simple-http) as the HTTP general interface (see the update [JustAuth 1.14.0 release! Perfect decoupling of HTTP tools](https://mp.weixin.qq.com/s?__biz=MzA3NDk3OTIwMg==&mid=2450633197&idx=1&sn=11e625b307db62b2f1c4e82f7744b2a2&chksm=88929300bfe51a16562b45592a264482ae2c74c6dbfa4a3aa9611ad4fea4a9be5b1f0545527d&token=1093833287&lang=zh_CN#rd)). Since most projects already integrate HTTP tools such as OkHttp3, apache HttpClient, and hutool-http), in order to reduce unnecessary dependencies,Starting from [v1.14.0](https://gitee.com/yadong.zhang/JustAuth/releases/v1.14.0), JustAuth will not integrate hutool-http by default. If the developer's project is new or there is no integrated HTTP implementation tool in the project, please add the corresponding HTTP implementation class by yourself. Alternative dependencies are as follows:
+
+
+- hutool-http
+
+  ```xml
+  <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-http</artifactId>
+      <version>5.2.5</version>
+  </dependency>
+  ```
+
+- httpclient
+
+  ```xml
+  <dependency>
+  	<groupId>org.apache.httpcomponents</groupId>
+    	<artifactId>httpclient</artifactId>
+    	<version>4.5.12</version>
+  </dependency>
+  ```
+
+- okhttp
+
+  ```xml
+  <dependency>
+    <groupId>com.squareup.okhttp3</groupId>
+    <artifactId>okhttp</artifactId>
+    <version>4.4.1</version>
+  </dependency>
+  ```
+
+
 **Examples**：
- [Springboot Example](https://gitee.com/yadong.zhang/JustAuth-demo)
- [jFinal Example](https://github.com/xkcoding/jfinal-justauth-demo)
- [ActFramework Example](https://github.com/xkcoding/act-justauth-demo)
+- [Springboot Example](https://github.com/justauth/JustAuth-demo)
+- [jFinal Example](https://github.com/xkcoding/jfinal-justauth-demo): by [xkcoding](https://github.com/xkcoding)
+- [ActFramework Example](https://github.com/xkcoding/act-justauth-demo): by [xkcoding](https://github.com/xkcoding)
+- [Nutzboot Example](https://github.com/EggsBlue/nutzboot-justauth-demo): by [蛋蛋](https://github.com/EggsBlue)
+- [Blade Example](https://github.com/justauth/blade-justauth-demo)

 **Springboot Starter**

- [justauth-spring-boot-starter](https://github.com/xkcoding/justauth-spring-boot-starter): Spring Boot integrates best practices with JustAuth
+- [justauth-spring-boot-starter](https://github.com/xkcoding/justauth-spring-boot-starter): Spring Boot integrates best practices with JustAuth by [xkcoding](https://github.com/xkcoding)
+- [justauth-spring-boot-starter-demo](https://github.com/justauth/justauth-spring-boot-starter-demo): Justauth-spring-boot-starter demo project by [xkcoding](https://github.com/xkcoding)

 #### API
 |  :computer: platform  |  :coffee: API  |  :page_facing_up: Official document  |
 |:------:|:-------:|:-------:|
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitee.png" width="20">  |  [AuthGiteeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGiteeRequest.java)  | <a href="https://gitee.com/api/v5/oauth_doc#list_1" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/github.png" width="20">  |  [AuthGithubRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGiteeRequest.java)  |  <a href="https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps/" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/weibo.png" width="20">  |  [AuthWeiboRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGiteeRequest.java)  |  <a href="https://open.weibo.com/wiki/%E6%8E%88%E6%9D%83%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E" target="_blank">参考文档</a>  |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/github.png" width="20">  |  [AuthGithubRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGithubRequest.java)  |  <a href="https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps/" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/weibo.png" width="20">  |  [AuthWeiboRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeiboRequest.java)  |  <a href="https://open.weibo.com/wiki/%E6%8E%88%E6%9D%83%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E" target="_blank">参考文档</a>  |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/dingtalk.png" width="20">  |  [AuthDingTalkRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthDingTalkRequest.java)  |  <a href="https://open-doc.dingtalk.com/microapp/serverapi2/kymkv6" target="_blank">参考文档</a>  |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/baidu.png" width="20">  |  [AuthBaiduRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthBaiduRequest.java)  |  <a href="http://developer.baidu.com/wiki/index.php?title=docs/oauth" target="_blank">参考文档</a>  |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/coding.png" width="25">  |  [AuthCodingRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCodingRequest.java)  |  <a href="https://open.coding.net/references/oauth/" target="_blank">参考文档</a> |
@@ -133,7 +174,9 @@ authRequest.login(callback);
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/oschina.png" width="20">  |  [AuthOschinaRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthOschinaRequest.java)  |  <a href="https://www.oschina.net/openapi/docs/oauth2_authorize" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/alipay.png" width="20">  |  [AuthAlipayRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthAlipayRequest.java)  |  <a href="https://alipay.open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.336d4b70GUKXOl&treeId=193&articleId=105809&docType=1" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/qq.png" width="20">  |  [AuthQqRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthQqRequest.java)  |  <a href="https://wiki.connect.qq.com/%E4%BD%BF%E7%94%A8authorization_code%E8%8E%B7%E5%8F%96access_token" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20">  |  [AuthWeChatRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatRequest.java)   |  <a href="https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419316505&token=&lang=zh_CN" target="_blank">参考文档</a>  |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20" title="微信开放平台">  |  [AuthWeChatOpenRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatOpenRequest.java)  |  <a href="https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419316505&token=&lang=zh_CN" target="_blank">参考文档</a>  |
+| <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20" title="微信公众平台"> | [AuthWeChatMpRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatMpRequest.java) | <a href="https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20" title="企业微信">  | [AuthWeChatEnterpriseRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatEnterpriseRequest.java) | <a href="https://open.work.weixin.qq.com/api/doc#90000/90135/90664" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/taobao.png" width="20">  |  [AuthTaobaoRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTaobaoRequest.java)   |  <a href="https://open.taobao.com/doc.htm?spm=a219a.7386797.0.0.4e00669acnkQy6&source=search&docId=105590&docType=1" target="_blank">参考文档</a>  |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/google.png" width="20">  |  [AuthGoogleRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGoogleRequest.java)   |  <a href="https://developers.google.com/identity/protocols/OpenIDConnect" target="_blank">参考文档</a>  |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/facebook.png" width="20">  |  [AuthFacebookRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthFacebookRequest.java)   |  <a href="https://developers.facebook.com/docs/facebook-login/manually-build-a-login-flow" target="_blank">参考文档</a>  |
@@ -147,9 +190,11 @@ authRequest.login(callback);
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/pinterest.png" width="20">  | [AuthPinterestRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthPinterestRequest.java) | <a href="https://developers.pinterest.com/docs/api/overview/?" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/stackoverflow.png" width="20">  | [AuthStackOverflowRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthStackOverflowRequest.java) | <a href="https://api.stackexchange.com/docs/authentication" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/huawei.png" width="20">  | [AuthHuaweiRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthHuaweiRequest.java) | <a href="https://developer.huawei.com/consumer/cn/devservice/doc/30101" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20">  | [AuthWeChatEnterpriseRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatEnterpriseRequest.java) | <a href="https://open.work.weixin.qq.com/api/doc#90000/90135/90664" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/kujiale.png" width="20">  |  [AuthKujialeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthKujialeRequest.java)  |  <a href="https://open.kujiale.com/open/apps/2/docs?doc_id=95" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitlab.png" width="20">  |  [AuthGitlabRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGitlabRequest.java)  |  <a href="https://docs.gitlab.com/ee/api/oauth2.html" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/meituan.png" width="20">  |  [AuthMeituanRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthMeituanRequest.java)  |  <a href="http://open.waimai.meituan.com/openapi_docs/oauth/" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/eleme.png" width="20">  |  [AuthElemeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthElemeRequest.java)  |  <a href="https://open.shop.ele.me/openapi/documents/khd001" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20">  |  [AuthTwitterRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTwitterRequest.java)  |  <a href="https://developer.twitter.com/en/docs/twitter-for-websites/log-in-with-twitter/guides/implementing-sign-in-with-twitter" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/csdn.png" width="20">  |  [AuthCsdnRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCsdnRequest.java)  |  无 |


@@ -165,7 +210,19 @@ authRequest.login(callback);

 I look forward to your joining us.

+
+## Contributors
+
+[contributors](https://docs.justauth.whnb.wang/#/contributors)
+
+## Recommend
+
+- `spring-boot-demo` In-depth study and actual combat of spring boot projects: [https://github.com/xkcoding/spring-boot-demo](https://github.com/xkcoding/spring-boot-demo)
+- `mica` Efficient Development of scaffolding by Spring Cloud: [https://github.com/lets-mica/mica](https://github.com/lets-mica/mica)
+- `pig` Cosmic strongest Micro Services Certified authorized scaffolding (essential for Architects): [https://gitee.com/log4j/pig](https://gitee.com/log4j/pig)
+- `SpringBlade` Complete online solution (necessary for enterprise development): https://gitee.com/smallc/SpringBlade
+
 ## References

 - [The OAuth 2.0 Authorization Framework](https://tools.ietf.org/html/rfc6749)
- [OAuth 2.0](https://oauth.net/2/)
+- [OAuth 2.0](https://oauth.net/2/)
@@ -1,12 +1,12 @@
 <p align="center">
-	<a href="https://www.justauth.cn/"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/logo.png" width="400"></a>
+	<a href="https://docs.justauth.whnb.wang"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/Justauth.png" width="400"></a>
 </p>
 <p align="center">
 	<strong>Login, so easy.</strong>
 </p>
 <p align="center">
 	<a target="_blank" href="https://search.maven.org/search?q=JustAuth">
-		<img src="https://img.shields.io/badge/Maven Central-1.11.0-blue.svg" ></img>
+		<img src="https://img.shields.io/badge/Maven%20Central--1.15.1-blue" ></img>
 	</a>
 	<a target="_blank" href="https://gitee.com/yadong.zhang/JustAuth/blob/master/LICENSE">
 		<img src="https://img.shields.io/apm/l/vim-mode.svg?color=yellow" ></img>
@@ -15,7 +15,7 @@
 		<img src="https://img.shields.io/badge/JDK-1.8+-green.svg" ></img>
 	</a>
 	<a target="_blank" href="https://apidoc.gitee.com/yadong.zhang/JustAuth/" title="API文档">
-		<img src="https://img.shields.io/badge/Api Docs-1.11.0-orange.svg" ></img>
+		<img src="https://img.shields.io/badge/Api%20Docs--1.15.1-latest-orange" ></img>
 	</a>
 	<a target="_blank" href="https://docs.justauth.whnb.wang" title="参考文档">
 		<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
@@ -44,7 +44,7 @@
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/oschina.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/alipay.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/qq.png" width="20"></td>
-            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20"></td>
+            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20" title="微信开放平台"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/taobao.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/google.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/facebook.png" width="20"></td>
@@ -66,13 +66,18 @@
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/csdn.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/kujiale.png" width="20"></td>
            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitlab.png" width="20"></td>
+            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/meituan.png" width="20"></td>
+            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/eleme.png" width="20"></td>
+            <td align="center" width="200"><img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20"></td>
        </tr>
    </table>
+    <center><a href="https://docs.justauth.whnb.wang/#/?id=%E5%B7%B2%E9%9B%86%E6%88%90%E7%9A%84%E5%B9%B3%E5%8F%B0" target="_blank">查看更多</a></center>
 </center>

 -------------------------------------------------------------------------------


+#### [2020年4月10日（周五） 晚8点 直播间首秀《JustAuth 从开源到喜提「码云GVP」之路》](https://mp.weixin.qq.com/s?__biz=MzA3NDk3OTIwMg==&mid=2450633207&idx=1&sn=50320bb20d468cb06e0c7f96d7181bb0&chksm=8892931abfe51a0c9d051b468ba4046beb5b50d8393b9e308798e25954184b5a0ef2a133203a&token=977722026&lang=zh_CN#rd)

 JustAuth，如你所见，它仅仅是一个**第三方授权登录**的**工具类库**，它可以让我们脱离繁琐的第三方登录SDK，让登录变得**So easy!**

@@ -83,7 +88,7 @@ JustAuth，如你所见，它仅仅是一个**第三方授权登录**的**工具

 废话不多说，就俩字：

-1. **全**：已集成十多家第三方平台（国内外常用的基本都已包含），后续依然还有扩展计划！
+1. **全**：已集成十多家第三方平台（国内外常用的基本都已包含），仍然还在持续扩展中（[开发计划](https://gitee.com/yadong.zhang/JustAuth/issues/IUGRK)）！
 2. **简**：API就是奔着最简单去设计的（见后面`快速开始`），尽量让您用起来没有障碍感！

 ## 快速开始
@@ -93,7 +98,7 @@ JustAuth，如你所见，它仅仅是一个**第三方授权登录**的**工具
 <dependency>
    <groupId>me.zhyd.oauth</groupId>
    <artifactId>JustAuth</artifactId>
-    <version>1.11.0</version>
+    <version>1.15.1</version>
 </dependency>
 ```
 - 调用api
@@ -111,31 +116,65 @@ authRequest.authorize("state");
 authRequest.login(callback);
 ```

-**配套Demo**：
- [Springboot版](https://gitee.com/yadong.zhang/JustAuth-demo)
- [jFinal版](https://github.com/xkcoding/jfinal-justauth-demo)
- [ActFramework版](https://github.com/xkcoding/act-justauth-demo)
+注意，JustAuth从[v1.14.0](https://gitee.com/yadong.zhang/JustAuth/releases/v1.14.0)开始默认集成了的[simple-http](https://github.com/xkcoding/simple-http)作为HTTP通用接口（更新说明见[JustAuth 1.14.0版本正式发布！完美解耦HTTP工具](https://mp.weixin.qq.com/s?__biz=MzA3NDk3OTIwMg==&mid=2450633197&idx=1&sn=11e625b307db62b2f1c4e82f7744b2a2&chksm=88929300bfe51a16562b45592a264482ae2c74c6dbfa4a3aa9611ad4fea4a9be5b1f0545527d&token=1093833287&lang=zh_CN#rd)），鉴于一般项目中都已经集成了HTTP工具，比如OkHttp3、apache HttpClient、hutool-http，因此为了减少不必要的依赖，从[v1.14.0](https://gitee.com/yadong.zhang/JustAuth/releases/v1.14.0)开始JustAuth将不会默认集成hutool-http，如果开发者的项目是全新的或者项目内没有集成HTTP实现工具，请自行添加对应的HTTP实现类，备选依赖如下：

-**扩展工具**
+- hutool-http

- [justauth-spring-boot-starter](https://github.com/xkcoding/justauth-spring-boot-starter): Spring Boot 集成 JustAuth 的最佳实践
+  ```xml
+  <dependency>
+      <groupId>cn.hutool</groupId>
+      <artifactId>hutool-http</artifactId>
+      <version>5.2.5</version>
+  </dependency>
+  ```

-**配套SpringBoot starter**：
+- httpclient

-[justauth-spring-boot-starter](https://github.com/xkcoding/justauth-spring-boot-starter)
+  ```xml
+  <dependency>
+  	<groupId>org.apache.httpcomponents</groupId>
+    	<artifactId>httpclient</artifactId>
+    	<version>4.5.12</version>
+  </dependency>
+  ```
+
+- okhttp
+
+  ```xml
+  <dependency>
+    <groupId>com.squareup.okhttp3</groupId>
+    <artifactId>okhttp</artifactId>
+    <version>4.4.1</version>
+  </dependency>
+  ```
+
+
+
+配套Demo**：
+
+- [JustAuth-demo](https://github.com/justauth/JustAuth-demo)
+- [jFinal版](https://github.com/xkcoding/jfinal-justauth-demo): Jfinal集成JustAuth的demo by [xkcoding](https://github.com/xkcoding)
+- [ActFramework版](https://github.com/xkcoding/act-justauth-demo): ActFramework 集成 JustAuth 的 demo by [xkcoding](https://github.com/xkcoding)
+- [Nutzboot版](https://github.com/EggsBlue/nutzboot-justauth-demo): NutzBoot集成JustAuth的demo  by [蛋蛋](https://github.com/EggsBlue)
+- [Blade版](https://github.com/justauth/blade-justauth-demo): Blade集成JustAuth的demo
+
+## 插件
+- [justauth-spring-boot-starter](https://github.com/xkcoding/justauth-spring-boot-starter): Spring Boot 集成 JustAuth 的最佳实践 by [xkcoding](https://github.com/xkcoding)
+- [justauth-spring-boot-starter-demo](https://github.com/justauth/justauth-spring-boot-starter-demo): Spring Boot 使用 justauth-spring-boot-starter 快速集成 JustAuth by [xkcoding](https://github.com/xkcoding)

 具体的例子可以参考：

 - [实现Gitee授权登录](http://t.cn/ExDKxQs)
 - [实现Github授权登录](http://t.cn/EJ0Fxqo)
- [Spring Boot 快速集成第三方登录功能](http://t.cn/AiWWx5kH)
+- [Spring Boot 快速集成第三方登录功能](http://t.cn/AiWWx5kH) : QQ、Github、微信、谷歌、微软、小米、企业微信
+- [集成企业微信](https://mp.weixin.qq.com/s?__biz=MzA3NDk3OTIwMg==&mid=2450633170&idx=2&sn=456b70742a86948a193c691f3e47b72e&chksm=8892933fbfe51a29c1da386a2252d4bf91bfbd14e1ac0b99b783763a0d12e2e4b2d7c4369933&token=482455242&lang=zh_CN#rd)

 #### API列表
 |  :computer: 平台  |  :coffee: API类  |  :page_facing_up: SDK  |
 |:------:|:-------:|:-------:|
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitee.png" width="20">  |  [AuthGiteeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGiteeRequest.java)  | <a href="https://gitee.com/api/v5/oauth_doc#list_1" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/github.png" width="20">  |  [AuthGithubRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGiteeRequest.java)  |  <a href="https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps/" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/weibo.png" width="20">  |  [AuthWeiboRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGiteeRequest.java)  |  <a href="https://open.weibo.com/wiki/%E6%8E%88%E6%9D%83%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E" target="_blank">参考文档</a>  |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/github.png" width="20">  |  [AuthGithubRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGithubRequest.java)  |  <a href="https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps/" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/weibo.png" width="20">  |  [AuthWeiboRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeiboRequest.java)  |  <a href="https://open.weibo.com/wiki/%E6%8E%88%E6%9D%83%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E" target="_blank">参考文档</a>  |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/dingtalk.png" width="20">  |  [AuthDingTalkRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthDingTalkRequest.java)  |  <a href="https://open-doc.dingtalk.com/microapp/serverapi2/kymkv6" target="_blank">参考文档</a>  |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/baidu.png" width="20">  |  [AuthBaiduRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthBaiduRequest.java)  |  <a href="http://developer.baidu.com/wiki/index.php?title=docs/oauth" target="_blank">参考文档</a>  |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/coding.png" width="25">  |  [AuthCodingRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCodingRequest.java)  |  <a href="https://open.coding.net/references/oauth/" target="_blank">参考文档</a> |
@@ -143,7 +182,9 @@ authRequest.login(callback);
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/oschina.png" width="20">  |  [AuthOschinaRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthOschinaRequest.java)  |  <a href="https://www.oschina.net/openapi/docs/oauth2_authorize" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/alipay.png" width="20">  |  [AuthAlipayRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthAlipayRequest.java)  |  <a href="https://alipay.open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.336d4b70GUKXOl&treeId=193&articleId=105809&docType=1" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/qq.png" width="20">  |  [AuthQqRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthQqRequest.java)  |  <a href="https://wiki.connect.qq.com/%E4%BD%BF%E7%94%A8authorization_code%E8%8E%B7%E5%8F%96access_token" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20">  |  [AuthWeChatRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatRequest.java)   |  <a href="https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419316505&token=&lang=zh_CN" target="_blank">参考文档</a>  |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20" title="微信开放平台">  |  [AuthWeChatOpenRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatOpenRequest.java)  |  <a href="https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419316505&token=&lang=zh_CN" target="_blank">参考文档</a>  |
+| <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20" title="微信公众平台"> | [AuthWeChatMpRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatMpRequest.java) | <a href="https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20" title="企业微信">  | [AuthWeChatEnterpriseRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatEnterpriseRequest.java) | <a href="https://open.work.weixin.qq.com/api/doc#90000/90135/90664" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/taobao.png" width="20">  |  [AuthTaobaoRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTaobaoRequest.java)   |  <a href="https://open.taobao.com/doc.htm?spm=a219a.7386797.0.0.4e00669acnkQy6&source=search&docId=105590&docType=1" target="_blank">参考文档</a>  |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/google.png" width="20">  |  [AuthGoogleRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGoogleRequest.java)   |  <a href="https://developers.google.com/identity/protocols/OpenIDConnect" target="_blank">参考文档</a>  |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/facebook.png" width="20">  |  [AuthFacebookRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthFacebookRequest.java)   |  <a href="https://developers.facebook.com/docs/facebook-login/manually-build-a-login-flow" target="_blank">参考文档</a>  |
@@ -157,9 +198,11 @@ authRequest.login(callback);
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/pinterest.png" width="20">  | [AuthPinterestRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthPinterestRequest.java) | <a href="https://developers.pinterest.com/docs/api/overview/?" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/stackoverflow.png" width="20">  | [AuthStackOverflowRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthStackOverflowRequest.java) | <a href="https://api.stackexchange.com/docs/authentication" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/huawei.png" width="20">  | [AuthHuaweiRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthHuaweiRequest.java) | <a href="https://developer.huawei.com/consumer/cn/devservice/doc/30101" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20">  | [AuthWeChatEnterpriseRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatEnterpriseRequest.java) | <a href="https://open.work.weixin.qq.com/api/doc#90000/90135/90664" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/kujiale.png" width="20">  |  [AuthKujialeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthKujialeRequest.java)  |  <a href="https://open.kujiale.com/open/apps/2/docs?doc_id=95" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitlab.png" width="20">  |  [AuthGitlabRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGitlabRequest.java)  |  <a href="https://docs.gitlab.com/ee/api/oauth2.html" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/meituan.png" width="20">  |  [AuthMeituanRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthMeituanRequest.java)  |  <a href="http://open.waimai.meituan.com/openapi_docs/oauth/" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/eleme.png" width="20">  |  [AuthElemeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthElemeRequest.java)  |  <a href="https://open.shop.ele.me/openapi/documents/khd001" target="_blank">参考文档</a> |
+|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/twitter.png" width="20">  |  [AuthTwitterRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTwitterRequest.java)  |  <a href="https://developer.twitter.com/en/docs/twitter-for-websites/log-in-with-twitter/guides/implementing-sign-in-with-twitter" target="_blank">参考文档</a> |
 |  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/csdn.png" width="20">  |  [AuthCsdnRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCsdnRequest.java)  |  无 |

 _请知悉：经咨询CSDN官方客服得知，CSDN的授权开放平台已经下线。如果以前申请过的应用，可以继续使用，但是不再支持申请新的应用。so, 本项目中的CSDN登录只能针对少部分用户使用了_
@@ -179,16 +222,26 @@ _请知悉：经咨询CSDN官方客服得知，CSDN的授权开放平台已经
 5. 发起PR（pull request） 请求，提交到`dev`分支
 6. 等待作者合并

+## 贡献者名单
+
+[contributors](https://docs.justauth.whnb.wang/#/contributors)
+
 ## 致谢

 在项目立项初期，也对当前开源圈的一些相同类型的项目作过调研，同时本项目也参考过这些项目，再次感谢开源圈内的朋友。

-[YurunOAuthLogin](https://gitee.com/yurunsoft/YurunOAuthLogin): PHP 第三方登录授权 SDK
-
-[阿里妈妈MUX倾力打造的矢量图标库-iconfont](https://www.iconfont.cn/search/index): 本文档中的图标大部分取自该平台
-
-[mica](https://github.com/lets-mica/mica)：Spring Cloud 微服务开发核心包，支持 `web `和 `webflux`。注：JustAuth项目中的[UuidUtils](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/utils/UuidUtils.java)就是直接使用的mica提供的高性能的uuid创建工具类源码[StringUtil.java](https://github.com/lets-mica/mica/blob/master/mica-core/src/main/java/net/dreamlu/mica/core/utils/StringUtil.java#L335)
+- [YurunOAuthLogin](https://gitee.com/yurunsoft/YurunOAuthLogin): PHP 第三方登录授权 SDK
+- [阿里妈妈MUX倾力打造的矢量图标库-iconfont](https://www.iconfont.cn/search/index): 本文档中的图标大部分取自该平台
+- [mica](https://github.com/lets-mica/mica)：Spring Cloud 微服务开发核心包，支持 `web `和 `webflux`。注：JustAuth项目中的[UuidUtils](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/utils/UuidUtils.java)就是直接使用的mica提供的高性能的uuid创建工具类源码[StringUtil.java](https://github.com/lets-mica/mica/blob/master/mica-core/src/main/java/net/dreamlu/mica/core/utils/StringUtil.java#L335)
+- 感谢 JetBrains 提供的免费开源 License：
+<img src="https://images.gitee.com/uploads/images/2020/0406/220236_f5275c90_5531506.png" alt="图片引用自lets-mica" style="float:left;">

+## 开源推荐
+- `spring-boot-demo` 深度学习并实战 spring boot 的项目: [https://github.com/xkcoding/spring-boot-demo](https://github.com/xkcoding/spring-boot-demo)
+- `mica` SpringBoot 微服务高效开发工具集: [https://github.com/lets-mica/mica](https://github.com/lets-mica/mica)
+- `pig` 宇宙最强微服务认证授权脚手架(架构师必备): [https://gitee.com/log4j/pig](https://gitee.com/log4j/pig)
+- `SpringBlade` 完整的线上解决方案（企业开发必备）: https://gitee.com/smallc/SpringBlade
+- `MaxKey` 马克思的钥匙，寓意是最大钥匙,是用户单点登录认证系统（Sigle Sign On System）,OAuth 2.0/OpenID Connect、SAML 2.0、JWT、CAS等标准化的开放协议，使用JustAuth集成OAuth第三方认证。: [https://shimingxy.github.io/MaxKey/](https://shimingxy.github.io/MaxKey/)
 ## 关于OAuth

 - [The OAuth 2.0 Authorization Framework](https://tools.ietf.org/html/rfc6749)
@@ -206,9 +259,10 @@ _请知悉：经咨询CSDN官方客服得知，CSDN的授权开放平台已经

 - 开源总群 （190886500）：各个开源项目的都有，也有博客建设等方面的朋友。

-
 ## 请喝咖啡

 | 支付宝  | 微信  |
 | :------------: | :------------: |
 | <img src="https://gitee.com/yadong.zhang/static/raw/master/qrcode/zfb_code.png" width="200"/> | <img src="https://gitee.com/yadong.zhang/static/raw/master/qrcode/wx_code.png" width="200" /> |
+
+通过“[爱发电](https://afdian.net/@zhangyadong)”赞助，感谢您的支持
@@ -0,0 +1,35 @@
+#!/bin/bash
+
+#-----------------------------------------------------------
+# 参考自 hutool 工具
+# 此脚本用于每次升级justauth时替换相应位置的版本号
+#-----------------------------------------------------------
+pwd=$(pwd)
+echo "当前路径：$pwd"
+
+if [ -n "$1" ];then
+    new_version="$1"
+    old_version=`cat $pwd/bin/version.txt`
+    echo "$old_version 替换为新版本 $new_version"
+else
+    # 参数错误，退出
+    echo "ERROR: 请指定新版本！"
+    exit
+fi
+
+if [ ! -n "$old_version" ]; then
+    echo "ERROR: 旧版本不存在，请确认bin/version.txt中信息正确"
+    exit
+fi
+
+# 替换README.md等文件中的版本
+sed -i "s/${old_version}/${new_version}/g" $pwd/README.md
+sed -i "s/${old_version}/${new_version}/g" $pwd/README.en-US.md
+sed -i "s/${old_version}/${new_version}/g" $pwd/docs/README.md
+sed -i "s/${old_version}/${new_version}/g" $pwd/docs/_coverpage.md
+
+# 替换pom.xml中的版本
+sed -i "s/${old_version}/${new_version}/g" $pwd/pom.xml
+
+# 保留新版本号
+echo "$new_version" > $pwd/bin/version.txt
@@ -0,0 +1,19 @@
+#!/bin/bash
+
+#------------------------------------------------
+# 参考自 hutool 工具
+# 升级justauth版本，包括：
+# 1. 升级pom.xml中的版本号
+# 2. 替换README.md中的版本号
+#------------------------------------------------
+
+if [ ! -n "$1" ]; then
+        echo "ERROR: 新版本不存在，请指定参数1"
+        exit
+fi
+
+# 替换所有模块pom.xml中的版本
+mvn versions:set -DnewVersion=$1
+
+# 替换其它地方的版本
+source $(pwd)/bin/repVersion.sh "$1"
@@ -0,0 +1 @@
+1.15.1
@@ -1,7 +0,0 @@
-# 项目贡献者名单
-
- <img src="https://avatar.gitee.com/uploads/99/784199_yadong.zhang.png!avatar100?1462325358" width="20"> · yadong.zhang :  <a href="https://github.com/zhangyd-c" target="_blank">[Github]</a> | <a href="https://gitee.com/yadong.zhang" target="_blank">[Gitee]</a> | <a href="https://www.zhyd.me" target="_blank">[个人网站]</a>
- <img src="https://avatars0.githubusercontent.com/u/10429917?s=460&v=4" width="20"> · yangkai.shen :  <a href="https://github.com/xkcoding" target="_blank">[Github]</a> | <a href="https://xkcoding.com" target="_blank">[个人网站]</a>
- <img src="https://avatar.gitee.com/uploads/51/1651_dolphinboy.png!avatar100?1479346570" width="20"> · skqing :  <a href="https://gitee.com/skqing" target="_blank">[Gitee]</a> | <a href="https://my.oschina.net/dolphinboy" target="_blank">[个人网站]</a>
- <img src="https://avatars2.githubusercontent.com/u/2988765?s=115&v=4" width="20"> · pengisgood :  <a href="https://github.com/pengisgood" target="_blank">[Github]</a> | <a href="https://pengisgood.github.io" target="_blank">[个人网站]</a>
- 千年等一回，我只为等你...
@@ -1,4 +1,25 @@
-## ~~升级到1.8.0后如何启用state？~~
+## 1.项目编译报错
+ **问题描述** 
+
+在使用JustAuth时，`AuthConfig.builder()`报错，提示没有`builder()`方法
+
+ **解决方案：** 
+
+安装完lombok插件即可
+
+[eclipse安装lombok](https://www.zhyd.me/article/61)    
+
+ **idea安装lombok：** file->settings->plugins->Browse Repositories->输入`lombok`，点击搜索->选中lombok点击install->安装完成后重启idea
+
+ **进阶版问题：** 
+idea中安装完lombok并重启idea之后，启动项目仍然报错：
+![输入图片说明](https://gitee.com/uploads/images/2018/0522/153610_ffe84828_784199.png "1.png")
+ **解决办法** 
+![输入图片说明](https://gitee.com/uploads/images/2018/0522/153715_75193de5_784199.jpeg "2.jpg")
+默认是eclipse  选择javac就可以了   
+ 
+
+## 2.~~升级到1.8.0后如何启用state？~~

 ~~在原api使用方法的基础上，为config追加一个state即可。~~
 ```
@@ -10,7 +31,7 @@ AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()
        .build());
 ```

-## ~~升级到1.8.0后login方法报错？~~
+## 3.~~升级到1.8.0后login方法报错？~~

 ~~这是因为1.8.0版本中新增了[AuthCallback](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/model/AuthCallback.java)类，这个类封装了所有可能的回调参数。目前包含以下三个参数：~~
 - ~~`code`: 访问AuthorizeUrl后回调时带的参数code，用来换取token~~
@@ -28,9 +49,9 @@ public Object login(@PathVariable("source") String source, AuthCallback callback
 	return response;
 }
 ```
- ~~_代码截取自_ ：https://gitee.com/yadong.zhang/JustAuth-demo~~
+ ~~_代码截取自_ ：https://github.com/justauth/JustAuth-demo~~

-## ~~升级到1.8.0后对于state参数有什么特殊要求吗？~~
+## 4.~~升级到1.8.0后对于state参数有什么特殊要求吗？~~

 ~~理论上没有，stata只是用来保持会话状态，因为http协议的无状态性，从授权到回调，无法感知具体是哪个用户触发的。所以可以使用state作为校验。注：state参数每次完整的授权链中只可用一次！（也是为了防止不必要的危险）~~

@@ -42,13 +63,13 @@ public Object login(@PathVariable("source") String source, AuthCallback callback

 ~~注：`authorize`和`login`（不是指回调传回的`state`，而是声明`request`时传入的`state`）中传的`state`务必保证一致~~

-## 升级到1.9.3+版本后编译失败
+## 5.升级到1.9.3+版本后编译失败

 主要明显的就是`IpUtils.getIp`和request的`.state`报错。

 这是因为从`v1.9.3`版本开始，对项目进行了一些优化，具体优化内容参考：[v1.9.3](https://gitee.com/yadong.zhang/JustAuth/releases/v1.9.3)和[v1.9.4](https://gitee.com/yadong.zhang/JustAuth/releases/v1.9.4)。

-新版本的使用方式，参考[JustAuth-demo](https://gitee.com/yadong.zhang/JustAuth-demo/blob/master/src/main/java/me/zhyd/justauth/RestAuthController.java)
+新版本的使用方式，参考[JustAuth-demo](https://github.com/justauth/JustAuth-demo/blob/master/src/main/java/me/zhyd/justauth/RestAuthController.java)
 ```
@RequestMapping("/render/{source}")
 public void renderAuth(@PathVariable("source") String source, HttpServletResponse response) throws IOException {
@@ -64,7 +85,7 @@ public Object login(@PathVariable("source") String source, AuthCallback callback
 }
 ```

-## 升级到最新版本后为什么支付宝登录不能用了？
+## 6.升级到最新版本后为什么支付宝登录不能用了？

 在升级到新版后，使用支付宝登录会提示`ClassNotFoundExcption`异常，这是因为从`1.9.4`版本开始，JustAuth将不在强依赖`alipay-sdk-java`，如果你需要用到Alipay的授权登陆，那么你还需要添加以下依赖：

@@ -75,3 +96,58 @@ public Object login(@PathVariable("source") String source, AuthCallback callback
 	<version>3.7.4.ALL</version>
 </dependency>
 ```
+
+## 7.“Scope参数错误或者Scope没有权限”是怎么回事？
+
+微信开放平台授权登录提示“Scope参数错误或者Scope没有权限”
+
+![Scope参数错误或者Scope没有权限](./_media/scope_error.png)
+
+解决办法：请检查微信开放平台的应用是否有“微信登录”接口的权限。
+
+![“微信登录”接口](./_media/scope_error2.png)
+
+“接口状态”必须为“已获得”！
+
+## 8.微信登录时能在微信端提示登录成功吗？
+
+不可以，这是**微信公众平台**的功能，截至到目前（JustAuth v1.12.0）为止，暂不支持**微信公众平台**的授权登录
+
+## 9.微信登录时能不需要手机确认吗？扫码后就自动登录
+
+不可以，微信开放平台不支持这种操作。可以把微信扫码登录理解成qq用账号密码登录，扫完码后不手动点确认，微信怎么知道用户是否同意了授权？    
+当然，**微信公众平台**的授权流程可以越过这个限制，只要关注了公众号，后续扫码成功后就会自动登录，但是这是**微信公众平台**的功能，截至到目前（JustAuth v1.12.0）为止，暂不支持**微信公众平台**的授权登录
+
+## 10.本地如何测那些*不支持本地地址回调*的授权登录？
+
+推荐几种方案：
+1. 改`hosts`，然后将测试程序的端口改为`80`
+2. 使用`Nginx`/`Apache`做代理
+3. FRP内网穿透，参考地址：[使用内网穿透的方式集成第三方登录](https://xkcoding.com/2019/05/22/spring-boot-login-with-oauth.html)
+
+## 11.如何获取QQ登录的`unionId`？
+
+在AuthConfig中设备`unionId`为`true`
+
+```java
+AuthRequest authRequest = new AuthQqRequest(AuthConfig.builder()
+        .clientId("clientId")
+        .clientSecret("clientSecret")
+        .redirectUri("redirectUri")
+        .unionId(true)
+        .build());
+```
+> 注：使用unionId要求开发者必须已在qq开放平台申请了获取unionId的权限，否则可能会发生错误！切记！参考链接：[unionid介绍](http://wiki.connect.qq.com/unionid%E4%BB%8B%E7%BB%8D)
+
+## 12. `AuthCallback`报错？
+
+在使用JustAuth 1.13.0时，遇到如下所示错误：
+![](./_media/authcallback_error.png)
+
+这是因为我没有做好代码审查和测试，所以才导致的问题。我检讨！深刻的检讨！
+
+请遇到该问题的朋友及时升级到最新版本（`1.13.1`修复该问题）
+
+ps: 我要去祭天了
+
+
@@ -1,5 +1,5 @@
 <p align="center">
-	<a href="https://www.justauth.cn/"><img src="./_media/cover.png" width="400"></a>
+	<a href="https://docs.justauth.whnb.wang"><img src="./_media/cover.png" width="400"></a>
 </p>
 <p align="center">
 	<strong>Login, so easy!</strong>
@@ -9,7 +9,7 @@
 </p>
 <p align="center">
 	<a target="_blank" href="https://search.maven.org/search?q=JustAuth">
-		<img src="https://img.shields.io/badge/Maven Central-1.11.0-blue.svg" ></img>
+		<img src="https://img.shields.io/badge/Maven%20Central--1.15.1-blue" ></img>
 	</a>
 	<a target="_blank" href="https://gitee.com/yadong.zhang/JustAuth/blob/master/LICENSE">
 		<img src="https://img.shields.io/apm/l/vim-mode.svg?color=yellow" ></img>
@@ -18,7 +18,7 @@
 		<img src="https://img.shields.io/badge/JDK-1.8+-green.svg" ></img>
 	</a>
 	<a target="_blank" href="https://apidoc.gitee.com/yadong.zhang/JustAuth/" title="API文档">
-		<img src="https://img.shields.io/badge/Api Docs-1.11.0-orange.svg" ></img>
+		<img src="https://img.shields.io/badge/Api%20Docs--1.15.1-latest-orange" ></img>
 	</a>
 	<a target="_blank" href="https://docs.justauth.whnb.wang" title="参考文档">
 		<img src="https://img.shields.io/badge/Docs-latest-blueviolet.svg" ></img>
@@ -51,72 +51,13 @@ JustAuth，如你所见，它仅仅是一个**第三方授权登录**的**工具

 废话不多说，就俩字：

-1. **全**：已集成十多家第三方平台（国内外常用的基本都已包含），后续依然还有扩展计划！
+1. **全**：已集成十多家第三方平台（国内外常用的基本都已包含），仍然还在持续扩展中（[开发计划](https://gitee.com/yadong.zhang/JustAuth/issues/IUGRK)）！
 2. **简**：API就是奔着最简单去设计的，尽量让您用起来没有障碍感！

 ## 项目关注度趋势

 [![Stargazers over time](https://starchart.cc/justauth/JustAuth.svg)](https://starchart.cc/justauth/JustAuth)

-## 已集成的平台
-
-|  :computer: 平台  |  :coffee: API类  |  :page_facing_up: SDK  |
-|:------:|:-------:|:-------:|
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitee.png" width="20">  |  [AuthGiteeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGiteeRequest.java)  | <a href="https://gitee.com/api/v5/oauth_doc#list_1" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/github.png" width="20">  |  [AuthGithubRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGiteeRequest.java)  |  <a href="https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps/" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/weibo.png" width="20">  |  [AuthWeiboRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGiteeRequest.java)  |  <a href="https://open.weibo.com/wiki/%E6%8E%88%E6%9D%83%E6%9C%BA%E5%88%B6%E8%AF%B4%E6%98%8E" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/dingtalk.png" width="20">  |  [AuthDingTalkRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthDingTalkRequest.java)  |  <a href="https://open-doc.dingtalk.com/microapp/serverapi2/kymkv6" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/baidu.png" width="20">  |  [AuthBaiduRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthBaiduRequest.java)  |  <a href="http://developer.baidu.com/wiki/index.php?title=docs/oauth" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/coding.png" width="25">  |  [AuthCodingRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCodingRequest.java)  |  <a href="https://open.coding.net/references/oauth/" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/tencentCloud.png" width="25">  |  [AuthTencentCloudRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTencentCloudRequest.java)  |  <a href="https://dev.tencent.com/help/doc/faq/b4e5b7aee786/oauth" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/oschina.png" width="20">  |  [AuthOschinaRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthOschinaRequest.java)  |  <a href="https://www.oschina.net/openapi/docs/oauth2_authorize" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/alipay.png" width="20">  |  [AuthAlipayRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthAlipayRequest.java)  |  <a href="https://alipay.open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.336d4b70GUKXOl&treeId=193&articleId=105809&docType=1" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/qq.png" width="20">  |  [AuthQqRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthQqRequest.java)  |  <a href="https://wiki.connect.qq.com/%E4%BD%BF%E7%94%A8authorization_code%E8%8E%B7%E5%8F%96access_token" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20">  |  [AuthWeChatRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatRequest.java)   |  <a href="https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419316505&token=&lang=zh_CN" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/taobao.png" width="20">  |  [AuthTaobaoRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTaobaoRequest.java)   |  <a href="https://open.taobao.com/doc.htm?spm=a219a.7386797.0.0.4e00669acnkQy6&source=search&docId=105590&docType=1" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/google.png" width="20">  |  [AuthGoogleRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGoogleRequest.java)   |  <a href="https://developers.google.com/identity/protocols/OpenIDConnect" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/facebook.png" width="20">  |  [AuthFacebookRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthFacebookRequest.java)   |  <a href="https://developers.facebook.com/docs/facebook-login/manually-build-a-login-flow" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/douyin.png" width="20">  |  [AuthDouyinRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthDouyinRequest.java)   |  <a href="https://www.douyin.com/platform/doc/m-2-1-1" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/linkedin.png" width="20">  |  [AuthLinkedinRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthLinkedinRequest.java)   |  <a href="https://docs.microsoft.com/zh-cn/linkedin/shared/authentication/authorization-code-flow?context=linkedin/context" target="_blank">参考文档</a>  |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/microsoft.png" width="20">  | [AuthMicrosoftRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthMicrosoftRequest.java) | <a href="https://docs.microsoft.com/zh-cn/graph/auth/" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/mi.png" width="20">  | [AuthMiRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthMiRequest.java) | <a href="https://dev.mi.com/console/doc/detail?pId=711" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/toutiao.png" width="20">  | [AuthToutiaoRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthToutiaoRequest.java) | <a href="https://open.mp.toutiao.com/#/resource?_k=y7mfgk" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/teambition.png" width="20">  | [AuthTeambitionRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthTeambitionRequest.java) | <a href="https://docs.teambition.com/" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/renren.png" width="20">  | [AuthRenrenRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthRenrenRequest.java) | <a href="http://open.renren.com/wiki/OAuth2.0" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/pinterest.png" width="20">  | [AuthPinterestRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthPinterestRequest.java) | <a href="https://developers.pinterest.com/docs/api/overview/?" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/stackoverflow.png" width="20">  | [AuthStackOverflowRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthStackOverflowRequest.java) | <a href="https://api.stackexchange.com/docs/authentication" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/huawei.png" width="20">  | [AuthHuaweiRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthHuaweiRequest.java) | <a href="https://developer.huawei.com/consumer/cn/devservice/doc/30101" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/wechat.png" width="20">  | [AuthWeChatEnterpriseRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthWeChatEnterpriseRequest.java) | <a href="https://open.work.weixin.qq.com/api/doc#90000/90135/90664" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/csdn.png" width="20">  |  [AuthCsdnRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthCsdnRequest.java)  |  无 |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/kujiale.png" width="20">  |  [AuthKujialeRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthKujialeRequest.java)  |  <a href="https://open.kujiale.com/open/apps/2/docs?doc_id=95" target="_blank">参考文档</a> |
-|  <img src="https://gitee.com/yadong.zhang/static/raw/master/JustAuth/gitlab.png" width="20">  |  [AuthGitlabRequest](https://gitee.com/yadong.zhang/JustAuth/blob/master/src/main/java/me/zhyd/oauth/request/AuthGitlabRequest.java)  |  <a href="https://docs.gitlab.com/ee/api/oauth2.html" target="_blank">参考文档</a> |
-
-
-## 快速开始
-
- 引入依赖
-```xml
-<dependency>
-    <groupId>me.zhyd.oauth</groupId>
-    <artifactId>JustAuth</artifactId>
-    <version>${latest.version}</version>
-</dependency>
-```
- 调用api
-```java
-// 创建授权request
-AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()
-        .clientId("clientId")
-        .clientSecret("clientSecret")
-        .redirectUri("redirectUri")
-        .build());
-// 生成授权页面
-authRequest.authorize("state");
-// 授权登录后会返回code（auth_code（仅限支付宝））、state，1.8.0版本后，可以用AuthCallback类作为回调接口的参数
-// 注：JustAuth默认保存state的时效为3分钟，3分钟内未使用则会自动清除过期的state
-authRequest.login(callback);
-```
-
 ## 参与&贡献

 JustAuth的发展离不开朋友们的支持，时至今日，JustAuth已渐趋完善，但仍有很大的改善空间。欢迎各位朋友为JustAuth贡献一份力量。
@@ -153,6 +94,11 @@ JustAuth一共有两个主要分支：
 - 线上版分支（master）：稳定版，发布版就是这个分支的代码
 - 开发版分支（dev）：不保证稳定，新功能都会优先推送到该分支，对于想尝鲜的朋友，可以直接下载代码，然后源码编译dev分支

+## 开源推荐
+- `spring-boot-demo` 深度学习并实战 spring boot 的项目: [https://github.com/xkcoding/spring-boot-demo](https://github.com/xkcoding/spring-boot-demo)
+- `mica` SpringBoot 微服务高效开发工具集: [https://github.com/lets-mica/mica](https://github.com/lets-mica/mica)
+- `pig` 宇宙最强微服务认证授权脚手架(架构师必备): [https://gitee.com/log4j/pig](https://gitee.com/log4j/pig)
+- `SpringBlade` 完整的线上解决方案（企业开发必备）: https://gitee.com/smallc/SpringBlade

 ## 捐赠

@@ -0,0 +1,42 @@
+# :alien: 404:alien: 
+
+**非常感谢您对JustAuth的关注**，您现在查询的内容，作者正在补充中！
+
+您可能对以下文章感兴趣：
+
+- [OAuth的授权流程是什么样的？](https://docs.justauth.whnb.wang/#/oauth)
+- [如何使用JustAuth？](https://docs.justauth.whnb.wang/#/how-to-use)
+- [提问与回答？](https://docs.justauth.whnb.wang/#/Q&A)
+- [如何集成Github？](https://docs.justauth.whnb.wang/#/oauth/github)
+- [如何集成Gitee？](https://docs.justauth.whnb.wang/#/oauth/gitee)
+- [如何集成支付宝？](https://docs.justauth.whnb.wang/#/oauth/alipay)
+- [如何自定义state？](https://docs.justauth.whnb.wang/#/customize-the-state-cache)
+- [如何自定义接入自己搭建的oauth平台？](https://docs.justauth.whnb.wang/#/customize-the-oauth)
+- [有哪些配套项目？](https://docs.justauth.whnb.wang/#/supporting)
+
+### 想使用JustAuth集成第三方OAuth登录？
+
+- [Gitee登录](oauth/gitee.md)
+- [Github登录](oauth/github.md)
+- [qq登录](oauth/qq.md)
+- [微信开放平台登录](oauth/wechat_open.md)
+- [微博登录](oauth/weibo.md)
+- [支付宝登录](oauth/alipay.md)
+- [酷家乐登录](oauth/kujiale.md)
+- 更多文章，正在补充中...
+
+
+### 如果还是没有您想要的内容，您可以：
+
+1. (建议) 提Issue： 【[github](https://github.com/justauth/JustAuth/issues)】 | 【[gitee](https://gitee.com/yadong.zhang/JustAuth/issues)】
+2. 点击本页面右下角【OPEN CHAT】开始在线聊天
+3. 本页面底部直接留言
+4. 关注公众号（公众号会不定期推送相关内容），扫下方二维码关注公众号：
+
+<img src="https://gitee.com/yadong.zhang/static/raw/master/wx/wechat_account.jpg" width="200" />
+
+4. 加微信群（群内有各个优秀开源项目的作者和技术大神），微信扫下方二维码后加我好友（**注：一定要备注JustAUth，无备注的一律不加**）：
+
+<img src="https://gitee.com/yadong.zhang/static/raw/master/wx/wx.png" width="170"/>
+
+5. 加QQ群：QQ搜索`230017570`（该QQ群为JustAuth官方技术讨论群，禁止群内打广告！）
@@ -1,6 +1,8 @@

-![](_media/logo.png)
-# JustAuth <small>1.11.0</small>
+![](_media/justauth@0,25x.png)
+# JustAuth <small>1.15.1</small>
+
+<a href="https://mp.weixin.qq.com/s?__biz=MzA3NDk3OTIwMg==&mid=2450633207&idx=1&sn=50320bb20d468cb06e0c7f96d7181bb0&chksm=8892931abfe51a0c9d051b468ba4046beb5b50d8393b9e308798e25954184b5a0ef2a133203a&token=977722026&lang=zh_CN#rd" target="_blank"><h2><strong style="color:red">2020年4月10日（周五） 晚8点 直播间首秀《JustAuth 从开源到喜提「码云GVP」之路》</strong></h2></a>

 <strong>史上最全的整合第三方登录的开源库</strong>

@@ -1,13 +1,49 @@
 - [入门和使用](README.md)
+- [贡献者名单](contributors.md)
 - 快速开始
  - [名词解释](explain.md)
+  - [OAuth流程](oauth.md)
  - [如何使用](how-to-use.md)
-  - [获取授权链接](authorize.md)
-  - [登录](login.md)
- 其他特性
+- [Q&A](Q&A.md)
+- 集成第三方
+  - [√ Gitee登录](oauth/gitee.md)
+  - [√ Github登录](oauth/github.md)
+  - [√ qq登录](oauth/qq.md)
+  - [√ 微信开放平台登录](oauth/wechat_open.md)
+  - [√ 微博登录](oauth/weibo.md)
+  - [√ 支付宝登录](oauth/alipay.md)
+  - [√ 酷家乐登录](oauth/kujiale.md)
+  - [微信企业版登录](oauth/wechatEnterprise.md)
+  - [微信公众平台登录](oauth/wechat_mp.md)
+  - [百度登录](oauth/baidu.md)
+  - [Coding登录](oauth/coding.md)
+  - [钉钉登录](oauth/dingtalk.md)
+  - [开源中国登录](oauth/oschina.md)
+  - [淘宝登录](oauth/taobao.md)
+  - [腾讯云登录](oauth/tencentCloud.md)
+  - [Google登录](oauth/google.md)
+  - [Facebook登录](oauth/facebook.md)
+  - [抖音登录](oauth/douyin.md)
+  - [领英登录](oauth/linkedin.md)
+  - [微软登录](oauth/microsoft.md)
+  - [小米登录](oauth/mi.md)
+  - [头条登录](oauth/toutiao.md)
+  - [Teambition登录](oauth/teambition.md)
+  - [人人登录](oauth/renren.md)
+  - [Pinterest登录](oauth/pinterest.md)
+  - [Stackoverflow登录](oauth/stackoverflow.md)
+  - [华为登录](oauth/huawei.md)
+  - [Gitlab登录](oauth/gitlab.md)
+  - [美团登录](oauth/meituan.md)
+  - [饿了么登录](oauth/eleme.md)
+  - [CSDN登录](oauth/csdn.md)
+  - [飞书登录](oauth/feishu.md)
+- 高级特性
  - [使用State](using-state.md)
  - [自定义state缓存](customize-the-state-cache.md)
- [配套项目](supporting.md)
- [Q&A](Q&A.md)
+  - [自定义第三方平台的OAuth](customize-the-oauth.md)
+- 扩展内容
+  - [JustAuth与现有用户系统整合](extended/justauth_integrated_with_the_existing_account_system.md)
 - [Who is using](users.md)
+- [致谢](thx.md)
 - [更新记录](update.md)
@@ -1,3 +0,0 @@
-# 获取授权链接
-
-待补充
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,7 @@
+（敬请期待...）
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,10 @@
+（敬请期待...）
+
+### 声明：
+此文档适用于**微信公众平台**！
+
+## 1. 申请应用
+
+## 2. 集成JustAuth
+
+## 3. 授权结果
@@ -0,0 +1,36 @@
+# 项目贡献者名单
+
+> 排序不分先后
+
+- <img src="https://avatar.gitee.com/uploads/99/784199_yadong.zhang.png!avatar100?1462325358" width="20"> · yadong.zhang :  <a href="https://github.com/zhangyd-c" target="_blank">[Github]</a> | <a href="https://gitee.com/yadong.zhang" target="_blank">[Gitee]</a> | <a href="https://www.zhyd.me" target="_blank">[个人网站]</a>
+- <img src="https://avatars0.githubusercontent.com/u/10429917?s=460&v=4" width="20"> · yangkai.shen :  <a href="https://github.com/xkcoding" target="_blank">[Github]</a> | <a href="https://xkcoding.com" target="_blank">[个人网站]</a>    
+  - 集成微信登录、QQ登录、Google登录、微软登录、小米登录、企业微信登录
+  - 优化代码、架构，增加自定义缓存
+  - 提供jFinal版demo
+  - 提供ActFramework版demo
+  - 提供SpringBoot快速集成的justauth-spring-boot-starter
+- <img src="https://avatars2.githubusercontent.com/u/2988765?s=115&v=4" width="20"> · pengisgood :  <a href="https://github.com/pengisgood" target="_blank">[Github]</a> | <a href="https://pengisgood.github.io" target="_blank">[个人网站]</a>
+  - 集成人人登录、Pinterest登录、StackOverflow登录、Twitter登录
+- <img src="https://avatar.gitee.com/uploads/51/1651_dolphinboy.png!avatar100?1479346570" width="20"> · skqing :  <a href="https://gitee.com/skqing" target="_blank">[Gitee]</a> | <a href="https://my.oschina.net/dolphinboy" target="_blank">[个人网站]</a>    
+  - 修复钉钉登录的部分问题
+  - 优化微博登录
+- <img src="https://avatars1.githubusercontent.com/u/47110161?s=88&v=4" width="20"> · dyc12ii :  <a href="https://github.com/dyc12ii" target="_blank">[Gitee]</a>
+  - 升级fastjson版本至1.2.58
+- <img src="https://gitee.com/uploads/22/4981222_harryleexyz.png?1556524275" width="20"> · harrylee :  <a href="https://gitee.com/harryleexyz" target="_blank">[Gitee]</a>
+  - 升级fastjson依赖到1.2.60
+  - 集成京东登录
+- <img src="https://avatars3.githubusercontent.com/u/32814990?s=460&v=4" width="20"> · Veigar :  <a href="https://github.com/wuweiqi1993" target="_blank">[Github]</a>
+  -  集成酷家乐登录
+- <img src="https://avatar.gitee.com/uploads/24/1280924_TopCoderMyDream.png!avatar200?1523763232" width="20"> · 蛋蛋 :  <a href="https://gitee.com/TopCoderMyDream" target="_blank">[Gitee]</a> | <a href="https://github.com/EggsBlue" target="_blank">[Github]</a>
+  -  提供NutzBoot版的demo项目
+- <img src="https://avatars0.githubusercontent.com/u/35978114?s=180&v=4" width="20"> · Braavos96 :  <a href="https://github.com/Braavos96" target="_blank">[Github]</a>
+  -  添加测试用例：UrlBuilder 、GlobalAuthUtil 
+- <img src="https://avatars0.githubusercontent.com/u/283483?s=180&v=4" width="20"> · Chris Smowton :  <a href="https://github.com/smowton" target="_blank">[Github]</a>
+  -  添加测试用例：StringUtils
+- <img src="https://avatars1.githubusercontent.com/u/31759178?s=88&v=4" width="20"> · githubeacon :  <a href="https://github.com/githubeacon" target="_blank">[Github]</a>
+  -  增加飞书授权登录
+- <img src="https://avatars3.githubusercontent.com/u/20242284?s=88&u=2aeb7576bd61392e9fd94227d2b3048a9aea6f73&v=4" width="20"> · runningzyp :  <a href="https://github.com/runningzyp" target="_blank">[Github]</a>
+  -  修改文案错误
+- 千年等一回，我只为等你...
+
+ps: 如有遗漏，请告知
@@ -0,0 +1,209 @@
+# 自定义第三方平台的OAuth
+
+[JustAuth](https://github.com/justauth/JustAuth)发展到现在，基本上已经涵盖了国内外大多数知名的网站。[JustAuth](https://github.com/justauth/JustAuth)也一直以它的**全**和**简**，备受各位朋友的厚爱、支持。
+
+但现在OAuth技术越来越成熟，越来越多的个人站长或者企业都开始搭建自己的OAuth授权平台，那么针对这种情况，[JustAuth](https://github.com/justauth/JustAuth)并不能做到面面俱到，无法去集成所有支持OAuth的网站（这也是不现实的）。
+
+既然考虑到有这种需求，那么就要想办法解决，想办法填补漏洞，不为了自己，也为了陪伴[JustAuth](https://github.com/justauth/JustAuth)一路走来的所有朋友们。
+
+[JustAuth](https://github.com/justauth/JustAuth)开发团队也在[v1.12.0](https://github.com/justauth/JustAuth/releases/tag/v1.12.0)版本中新加入了一大特性，就是可以支持任意支持OAuth的网站通过JustAuth实现便捷的OAuth登录！
+
+下面我们会通过一个小例子，讲解如何使用JustAuth集成自己搭建的GitLab服务。
+
+> 注：本节将会使用[JustAuth-demo](https://github.com/justauth/JustAuth-demo)Demo项目进行演示
+
+## 搭建Gitlab服务
+
+请自行解决，如果已有搭建好的Gitlab私服，请直接进入下面的步骤
+
+## 创建应用
+
+![gitlab私服创建应用](./_media/custom/gitlab.png)
+![gitlab私服应用详情](./_media/custom/gitlab2.png)
+
+## 实现AuthSource接口
+
+`AuthSource.java`是为了提供OAuth平台的API地址的统一接口，提供以下方法供实现：
+- `AuthSource#authorize()`: 获取授权url. 必须实现
+- `AuthSource#accessToken()`: 获取accessToken的url. 必须实现
+- `AuthSource#userInfo()`: 获取用户信息的url. 必须实现
+- `AuthSource#revoke()`: 获取取消授权的url. 非必须实现接口（部分平台不支持）
+- `AuthSource#refresh()`: 获取刷新授权的url. 非必须实现接口（部分平台不支持）
+
+**注：**
+- 当通过JustAuth扩展实现第三方授权时，请参考`AuthDefaultSource`自行创建对应的枚举类并实现`AuthSource`接口
+- 如果不是使用的枚举类，那么在授权成功后获取用户信息时，需要**单独处理source字段**的赋值
+- 如果扩展了对应枚举类时，在`me.zhyd.oauth.request.AuthRequest#login(AuthCallback)`中可以通过`xx.toString()`获取对应的source
+
+```java
+package me.zhyd.justauth;
+
+import me.zhyd.oauth.config.AuthSource;
+
+/**
+ * @author yadong.zhang (yadong.zhang0415(a)gmail.com)
+ * @version 1.0
+ * @website https://www.zhyd.me
+ * @date 2019/10/26 16:54
+ * @since 1.8
+ */
+public enum AuthCustomSource implements AuthSource {
+
+    /**
+     * 自己搭建的gitlab私服
+     */
+    MYGITLAB {
+        /**
+         * 授权的api
+         *
+         * @return url
+         */
+        @Override
+        public String authorize() {
+            return "http://gitlab.xxx.com/oauth/authorize";
+        }
+
+        /**
+         * 获取accessToken的api
+         *
+         * @return url
+         */
+        @Override
+        public String accessToken() {
+            return "http://gitlab.xxx.com/oauth/token";
+        }
+
+        /**
+         * 获取用户信息的api
+         *
+         * @return url
+         */
+        @Override
+        public String userInfo() {
+            return "http://gitlab.xxx.com/api/v4/user";
+        }
+    }
+}
+```
+
+## 创建自定义的Request
+
+```java
+package me.zhyd.justauth;
+
+import cn.hutool.http.HttpResponse;
+import com.alibaba.fastjson.JSONObject;
+import me.zhyd.oauth.cache.AuthStateCache;
+import me.zhyd.oauth.config.AuthConfig;
+import me.zhyd.oauth.enums.AuthUserGender;
+import me.zhyd.oauth.exception.AuthException;
+import me.zhyd.oauth.model.AuthCallback;
+import me.zhyd.oauth.model.AuthToken;
+import me.zhyd.oauth.model.AuthUser;
+import me.zhyd.oauth.request.AuthDefaultRequest;
+import me.zhyd.oauth.utils.UrlBuilder;
+
+/**
+ * @author yadong.zhang (yadong.zhang0415(a)gmail.com)
+ * @version 1.0
+ * @website https://www.zhyd.me
+ * @date 2019/10/26 17:00
+ * @since 1.8
+ */
+public class AuthMyGitlabRequest extends AuthDefaultRequest {
+
+
+    public AuthMyGitlabRequest(AuthConfig config) {
+        super(config, AuthCustomSource.MYGITLAB);
+    }
+
+    public AuthMyGitlabRequest(AuthConfig config, AuthStateCache authStateCache) {
+        super(config, AuthCustomSource.MYGITLAB, authStateCache);
+    }
+
+    @Override
+    protected AuthToken getAccessToken(AuthCallback authCallback) {
+        HttpResponse response = doPostAuthorizationCode(authCallback.getCode());
+        JSONObject object = JSONObject.parseObject(response.body());
+
+        this.checkResponse(object);
+
+        return AuthToken.builder()
+                .accessToken(object.getString("access_token"))
+                .refreshToken(object.getString("refresh_token"))
+                .idToken(object.getString("id_token"))
+                .tokenType(object.getString("token_type"))
+                .scope(object.getString("scope"))
+                .build();
+    }
+
+    @Override
+    protected AuthUser getUserInfo(AuthToken authToken) {
+        HttpResponse response = doGetUserInfo(authToken);
+        JSONObject object = JSONObject.parseObject(response.body());
+
+        this.checkResponse(object);
+
+        return AuthUser.builder()
+                .uuid(object.getString("id"))
+                .username(object.getString("username"))
+                .nickname(object.getString("name"))
+                .avatar(object.getString("avatar_url"))
+                .blog(object.getString("web_url"))
+                .company(object.getString("organization"))
+                .location(object.getString("location"))
+                .email(object.getString("email"))
+                .remark(object.getString("bio"))
+                .gender(AuthUserGender.UNKNOWN)
+                .token(authToken)
+                .source(source.toString())
+                .build();
+    }
+
+    private void checkResponse(JSONObject object) {
+        // oauth/token 验证异常
+        if (object.containsKey("error")) {
+            throw new AuthException(object.getString("error_description"));
+        }
+        // user 验证异常
+        if (object.containsKey("message")) {
+            throw new AuthException(object.getString("message"));
+        }
+    }
+
+    /**
+     * 返回带{@code state}参数的授权url，授权回调时会带上这个{@code state}
+     *
+     * @param state state 验证授权流程的参数，可以防止csrf
+     * @return 返回授权地址
+     * @since 1.11.0
+     */
+    @Override
+    public String authorize(String state) {
+        return UrlBuilder.fromBaseUrl(super.authorize(state))
+                .queryParam("scope", "read_user+openid")
+                .build();
+    }
+}
+```
+
+## 测试效果
+
+创建`AuthMyGitlabRequest`
+```java
+AuthRequest authRequest = new AuthMyGitlabRequest(AuthConfig.builder()
+    .clientId("63398e403231d4aa7e856cf5413620d536a876cb94e8d10ced0d3191b5d1d246")
+    .clientSecret("65b0eba68fff019e682e6755882a24dfdbf0a61be55de119cb8970320186c8eb")
+    .redirectUri("http://127.0.0.1:8443/oauth/callback/mygitlab")
+    .build());
+```
+
+> 注：完整代码都在[JustAuth-demo](https://github.com/justauth/JustAuth-demo)Demo项目中，本节只讲解关键代码
+
+登录后的效果为
+
+![gitlab私服验证授权](./_media/custom/gitlab3.png)
+![gitlab私服登录完成](./_media/custom/gitlab4.png)
+
+
+
@@ -1,3 +1,123 @@
 # 自定义state缓存
+> starter 内置了2种缓存实现，一种是上一节演示的默认实现，另一种是用户自定义的扩展实现。
+本节将会使用[JustAuth-demo](https://github.com/justauth/JustAuth-demo)Demo进行演示扩展Redis缓存的方式，当然了，你也可以自定义实现你自己的缓存。

-待补充
+## 添加 Redis 依赖
+```xml
+<dependency>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-data-redis</artifactId>
+</dependency>
+```
+
+### 添加redis配置
+
+```xml
+# 集成redis实现自定义的state缓存
+spring.redis.database=0
+spring.redis.host=localhost
+spring.redis.port=6379
+spring.redis.password=xxxx
+```
+### 实现state缓存接口
+
+```java
+package me.zhyd.justauth;
+
+import me.zhyd.oauth.cache.AuthCacheConfig;
+import me.zhyd.oauth.cache.AuthStateCache;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.data.redis.core.RedisTemplate;
+import org.springframework.data.redis.core.ValueOperations;
+import org.springframework.stereotype.Component;
+
+import javax.annotation.PostConstruct;
+import java.util.concurrent.TimeUnit;
+
+/**
+ * 扩展Redis版的state缓存
+ *
+ * @author yadong.zhang (yadong.zhang0415(a)gmail.com)
+ * @version 1.0
+ * @date 2019/10/24 13:38
+ * @since 1.8
+ */
+@Component
+public class AuthStateRedisCache implements AuthStateCache {
+
+    @Autowired
+    private RedisTemplate<String, String> redisTemplate;
+
+    private ValueOperations<String, String> valueOperations;
+
+    @PostConstruct
+    public void init() {
+        valueOperations = redisTemplate.opsForValue();
+    }
+
+    /**
+     * 存入缓存，默认3分钟
+     *
+     * @param key   缓存key
+     * @param value 缓存内容
+     */
+    @Override
+    public void cache(String key, String value) {
+        valueOperations.set(key, value, AuthCacheConfig.timeout, TimeUnit.MILLISECONDS);
+    }
+
+    /**
+     * 存入缓存
+     *
+     * @param key     缓存key
+     * @param value   缓存内容
+     * @param timeout 指定缓存过期时间（毫秒）
+     */
+    @Override
+    public void cache(String key, String value, long timeout) {
+        valueOperations.set(key, value, timeout, TimeUnit.MILLISECONDS);
+    }
+
+    /**
+     * 获取缓存内容
+     *
+     * @param key 缓存key
+     * @return 缓存内容
+     */
+    @Override
+    public String get(String key) {
+        return valueOperations.get(key);
+    }
+
+    /**
+     * 是否存在key，如果对应key的value值已过期，也返回false
+     *
+     * @param key 缓存key
+     * @return true：存在key，并且value没过期；false：key不存在或者已过期
+     */
+    @Override
+    public boolean containsKey(String key) {
+        return redisTemplate.hasKey(key);
+    }
+}
+```
+
+### 获取Request
+
+本节以Gitee为例
+
+```java
+// 1. 注入新添加的cache
+@Autowired
+private AuthStateRedisCache stateRedisCache;
+
+// 2. 创建request时传入stateRedisCache
+AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()
+      .clientId("clientId")
+      .clientSecret("clientSecret")
+      .redirectUri("redirectUri")
+      .build(), stateRedisCache);// 此处传入自定义实现的类
+```
+
+
+到此已经完成了通过redis**扩展实现state缓存**的功能。当然，只要你愿意，你可以使用**任何一种**缓存技术去实现这个功能，并不局限于redis。
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
yadong.zhang	be1e23e2ab	📝 更新文档	2020-04-10 16:02:29 +08:00
yadong.zhang	739e7dfd39	🔖 发布一个版本, 1.15.1，1.15.0版有问题，请不要使用。抱歉	2020-04-10 15:53:14 +08:00
yadong.zhang	58c8aa9010	🔖 发布一个版本, 1.15.0	2020-04-10 15:46:29 +08:00
yadong.zhang	93aae33f0a	🔖 发布一个版本, 1.15.0	2020-04-10 15:45:27 +08:00
yadong.zhang	268a9b477b	🔖 发布一个版本, 1.15.0	2020-04-10 15:18:19 +08:00
yadong.zhang	adaf9d59cd	Merge pull request #69 from dengliming/master Upgrade fastjson version	2020-04-10 15:16:01 +08:00
yadong.zhang	7f0f1e17d2	👽 等待simple-http发版，解决使用apache-httpclient时的403bug	2020-04-09 22:58:34 +08:00
yadong.zhang	65b2db32b5	📝 编写文档	2020-04-08 01:06:56 +08:00
yadong.zhang	9e79dd7cb3	Merge branch 'master' into dev	2020-04-08 01:01:58 +08:00
yadong.zhang	30f29a49d1	📝 编写文档	2020-04-08 00:59:51 +08:00
yadong.zhang	129d1d57ed	!14 【轻量级 PR】：update README.md. Merge pull request !14 from shimingxy/N/A	2020-04-06 22:24:20 +08:00
shimingxy	3da90736c4	update README.md. MaxKey使用JustAuth集成OAuth第三方认证	2020-04-06 22:05:01 +08:00
yadong.zhang	05891e48e9	✨ 公告	2020-04-05 00:29:55 +08:00
dengliming	9ef19b1d54	Upgrade fastjson version	2020-04-03 17:51:58 +08:00
yadong.zhang	2de19a3824	✨ 合并 https://gitee.com/yadong.zhang/JustAuth/pulls/10，增加京东登录	2020-03-28 21:01:41 +08:00
yadong.zhang	bccf3279af	✅ 完善单测	2020-03-28 21:00:28 +08:00
yadong.zhang	6b4a8b78b1	📝 Writing docs.	2020-03-21 13:08:11 +08:00
yadong.zhang	5a94ff82c1	🍻 gitter	2020-03-21 12:44:09 +08:00
yadong.zhang	7b03751a8d	📝 Writing docs.	2020-03-21 12:39:55 +08:00
yadong.zhang	823a43b1e2	🔧 修改pom	2020-03-18 01:33:31 +08:00
yadong.zhang	db6e88173a	🔧 修改pom	2020-03-18 00:54:46 +08:00
yadong.zhang	c6481a681e	✅ 修改测试用例	2020-03-17 23:27:36 +08:00
yadong.zhang	1e1038fbd4	✅ 修改测试用例，增加scope为test的http工具依赖	2020-03-17 23:26:12 +08:00
yadong.zhang	7cb0f8dbb6	✅ 修改测试用例	2020-03-17 23:18:07 +08:00
yadong.zhang	65c60a61b3	🔖 发布1.14.0，解耦HTTP工具	2020-03-17 22:57:53 +08:00
yadong.zhang	d5a8ffcab2	Merge pull request #61 from githubeacon/master 增加飞书授权登录	2020-01-26 21:08:43 +08:00
yadong.zhang	c95c118f88	Merge pull request #65 from runningzyp/dev 更新文档	2020-01-26 21:07:13 +08:00
YunpengZhan	fec9a3c214	更新文档	2020-01-19 18:05:03 +08:00
yadong.zhang	6439058bda	📝 更新文档	2020-01-07 20:43:44 +08:00
beacon	a1d31018d3	增加飞书授权登录	2019-12-30 21:16:48 +08:00
yadong.zhang	2a9d8e81a1	Merge branch 'master' into dev # Conflicts: # pom.xml	2019-12-26 12:36:52 +08:00
yadong.zhang	dda873ca11	Merge pull request #59 from xkcoding/extract-http ♻️ 抽取 HTTP，具体实现交给使用者，解耦 hutool-http	2019-12-26 12:35:52 +08:00
Yangkai.Shen	8dc4b5d7d6	♻️ 抽取 HTTP，具体实现交给使用者，解耦 hutool-http	2019-12-25 18:28:18 +08:00
yadong.zhang	2038f24b3b	Merge branch 'dev'	2019-12-24 19:37:33 +08:00
yadong.zhang	f8f13fdb10	Merge branch 'dev' of https://gitee.com/yadong.zhang/JustAuth into dev	2019-12-24 19:36:41 +08:00
yadong.zhang	697c07cccc	📝 更新文档，加入发版日期	2019-12-24 19:35:39 +08:00
yadong.zhang	e868d43ca3	🥚 添加实用工具，方便每次发版批量更新依赖版本	2019-12-24 19:34:39 +08:00
yadong.zhang	0700d7ee25	🔖 更新版本	2019-12-24 19:33:17 +08:00
yadong.zhang	822b4806a1	🍻 调整微信平台获取用户性别的代码逻辑，单独适配微信平台	2019-12-24 19:22:38 +08:00
yadong.zhang	ab8c24ee5c	🍻 调整过获取用户性别的逻辑	2019-12-24 18:47:57 +08:00
yadong.zhang	cd24cbdd58	Merge pull request #57 from xkcoding/wechat-mp ✨ 集成微信公众号登录，修改之前的微信登录为微信开放平台登录	2019-12-24 11:00:18 +08:00
Yangkai.Shen	4bc9c09610	📝 修改文档，区分公众平台和开放平台	2019-12-23 13:54:27 +08:00
Yangkai.Shen	4d2518e21a	✨ 集成微信公众号登录，修改之前的微信登录为微信开放平台登录	2019-12-23 13:47:40 +08:00
yadong.zhang	f47dc074e7	update docs/index.html.	2019-12-23 09:54:52 +08:00
yadong.zhang	b7f01549c1	update docs/index.html.	2019-12-23 09:49:15 +08:00
yadong.zhang	264294caee	📝 添加微博授权登录的帮助文档	2019-12-22 20:03:22 +08:00
yadong.zhang	19ec565004	🍻 增加微博授权登录的revoke方法，支持手动回收授权	2019-12-22 20:02:26 +08:00
yadong.zhang	028924ecbf	📝 完善文档	2019-12-22 16:58:34 +08:00
yadong.zhang	d2d3232501	📝 完善文档	2019-12-22 16:52:32 +08:00
yadong.zhang	1206847576	📝 添加Gittalk	2019-12-22 16:34:42 +08:00
yadong.zhang	2490c0f1ff	📝 自定义404页面	2019-12-22 16:34:14 +08:00
yadong.zhang	2fd7255ad4	📝 支付宝登录文档的图片	2019-12-22 14:56:45 +08:00
yadong.zhang	f7873d71b2	📝 完善文档	2019-12-12 15:05:26 +08:00
yadong.zhang	602b1eaf58	📝 添加支付宝授权登录的帮助文档	2019-12-12 15:03:39 +08:00
yadong.zhang	7c2bc82814	🎨 优化	2019-12-12 14:47:57 +08:00
yadong.zhang	28b764f0d2	📝 添加qq授权登录的帮助文档	2019-12-12 11:48:27 +08:00
yadong.zhang	2442661291	📝 添加qq授权登录的帮助文档	2019-12-12 11:48:07 +08:00
yadong.zhang	abb121a57c	📝 添加qq授权登录的帮助文档	2019-12-12 11:47:54 +08:00
yadong.zhang	51603e18ad	📝 添加微信授权登录的帮助文档	2019-12-12 11:30:54 +08:00
yadong.zhang	77c9680333	📝 编写文档	2019-12-10 17:21:09 +08:00
yadong.zhang	525c406c92	🐛 修复抖音登录取值取错层级的问题（issue#I15SIG@Gitee）	2019-12-10 17:15:19 +08:00
yadong.zhang	e65d87daa3	Merge branch 'dev' of https://gitee.com/yadong.zhang/JustAuth into dev	2019-12-05 17:39:48 +08:00
yadong.zhang	8639359f53	⬆️ 依赖升级	2019-12-05 17:39:08 +08:00
yadong.zhang	9eda5aaf2b	!11 注解更新、包版本升级 Merge pull request !11 from 燃點/master	2019-12-05 17:34:34 +08:00
yadong.zhang	9d6ceb3898	💩	2019-12-05 17:20:31 +08:00
yadong.zhang	7bb9864799	!12 注解更新、包版本升级 Merge pull request !12 from 燃點/master	2019-11-15 17:56:36 +08:00
刘勋	95e4db2315	alipay-sdk-version 升级 4.8.10.ALL	2019-11-12 18:17:10 +08:00
刘勋	fc4606dad3	fastjson 升级到 1.2.62	2019-11-12 18:15:21 +08:00
刘勋	31330a366d	hutool-http 升级到5.0.5	2019-11-12 18:14:51 +08:00
刘勋	7364c203ab	增加无参构造	2019-11-12 18:10:26 +08:00
yadong.zhang	c730072f07	📝 编写文档	2019-11-12 12:15:02 +08:00
yadong.zhang	3c3e9b63d5	🐛 拿我祭天前，先让我升级一下版本	2019-11-12 12:06:19 +08:00
yadong.zhang	100dacac91	🐛 拿我祭天吧	2019-11-12 12:04:00 +08:00
yadong.zhang	41dee559df	🐛 拿我祭天吧	2019-11-12 12:02:06 +08:00
yadong.zhang	b0769d09b3	Merge branch 'dev' of https://github.com/zhangyd-c/JustAuth into dev	2019-11-12 11:50:41 +08:00
yadong.zhang	c77c74be3c	Merge pull request #54 from jnan88/dev fix#52 AuthCallback在spring中接收参数异常	2019-11-12 11:09:03 +08:00
qizai	66fdec3e2e	fix#52 AuthCallback在spring中接收参数异常，需要有默认的构造方法,增加注解@AllArgsConstructor和@NoArgsConstructor	2019-11-08 12:06:21 +08:00
yadong.zhang	c674457f2f	📝 补充文档	2019-11-01 22:56:31 +08:00
yadong.zhang	0a0f6a34e8	📝 补充文档	2019-11-01 22:32:35 +08:00
yadong.zhang	366a6ac886	Merge branch 'dev'	2019-11-01 22:29:15 +08:00
yadong.zhang	15d03fcd07	📝 补充文档	2019-11-01 22:27:53 +08:00
yadong.zhang	c0b9010d84	google-site-verification	2019-10-31 11:29:30 +08:00
yadong.zhang	3cb7c0dd82	📝 补充文档	2019-10-26 17:46:25 +08:00
yadong.zhang	a23610c8b8	📝 补充文档：自定义state缓存、自定义实现oauth等	2019-10-26 17:43:21 +08:00
yadong.zhang	4e0fe3ba33	📝 补充文档：自定义state缓存、自定义实现oauth等	2019-10-26 17:41:59 +08:00
yadong.zhang	9f341389d2	🍻 集成推特	2019-10-22 18:16:31 +08:00
yadong.zhang	43459c3192	Merge pull request #49 from pengisgood/dev Integrate Twitter	2019-10-09 10:01:19 +08:00
Hongwei Peng	de038b852d	update doc	2019-09-30 10:19:53 +08:00
Hongwei Peng	da8ec82e74	refactor	2019-09-30 08:22:25 +08:00
Hongwei Peng	5ed7e1563b	integrate twitter login	2019-09-30 08:11:21 +08:00
yadong.zhang	3e9fdf7c35	!9 增加序列化标识解决直接引用Model序列化失败问题 Merge pull request !9 from -苏若年-/master	2019-09-25 15:23:58 +08:00
-苏若年-	427c5b6d38	序列化	2019-09-25 13:05:05 +08:00
-苏若年-	ea4beb71bc	序列化	2019-09-25 13:04:37 +08:00
-苏若年-	1334cd7378	序列化	2019-09-25 13:04:11 +08:00
-苏若年-	81eaca75ab	序列化	2019-09-25 13:03:41 +08:00
yadong.zhang	9e4815cde7	📝 修改demo链接	2019-09-23 09:16:21 +08:00
yadong.zhang	17630ea1bf	📝 修复文档错误	2019-09-22 01:31:18 +08:00
yadong.zhang	b8240ac210	🍻 文档、删除AuthRequestTest	2019-09-20 19:33:52 +08:00
yadong.zhang	3d7d37b651	🍻 文档、注释	2019-09-17 19:28:46 +08:00
yadong.zhang	94550e406f	🍻 文档	2019-09-17 19:17:55 +08:00
yadong.zhang	fdc78212ff	🍻 文档	2019-09-17 18:38:35 +08:00
yadong.zhang	51087658a4	🍻 完善饿了么授权登录	2019-09-11 19:46:16 +08:00
harrylee	469558bddc	✨ 集成京东	2019-09-11 15:06:50 +08:00
yadong.zhang	6567f17513	Merge branch 'master' into dev	2019-09-11 15:06:38 +08:00
yadong.zhang	6a3e061921	🍻 错别字	2019-09-11 11:18:35 +08:00
yadong.zhang	3a5a312b68	📝 编写文档	2019-09-11 11:16:31 +08:00
yadong.zhang	3ff0b36b49	Merge branch 'master' into dev	2019-09-11 09:20:10 +08:00
yadong.zhang	faae8816be	🍻 添加Nutzboot版Demo	2019-09-11 09:10:41 +08:00
yadong.zhang	6cf6a7d7dc	Merge branch 'master' of https://gitee.com/yadong.zhang/JustAuth	2019-09-11 09:07:04 +08:00
harrylee	d9952968d1	📝 集成京东	2019-09-10 23:51:08 +08:00
yadong.zhang	c424f9c9c0	!6 添加Nutzboot版本的Demo地址 Merge pull request !6 from 蛋蛋的忧伤/master	2019-09-10 20:17:55 +08:00
王庆华	726018031f	add: 添加NutzBoot版本的Demo,修改README	2019-09-10 19:28:56 +08:00
yadong.zhang	80f2dbdad7	✨ 提取公共的Source接口，支持自定义扩展第三方平台的授权登录，具体扩展例子可参考AuthExtendRequest	2019-09-06 22:21:35 +08:00
yadong.zhang	02f9f833e6	✨ 提取公共的Source接口，支持自定义扩展第三方平台的授权登录，具体扩展例子可参考AuthExtendRequest	2019-09-06 22:19:02 +08:00
yadong.zhang	05374e7a1f	✨ 集成“饿了么”授权登录（未测试）	2019-09-06 19:22:49 +08:00
yadong.zhang	1eacc41959	📝 编写文档	2019-09-06 16:56:29 +08:00
yadong.zhang	66c7455d30	✨ 集成美团，待发布1.12.0	2019-09-06 16:54:08 +08:00
yadong.zhang	055807d75f	!5 fix: Fastjson ＜ 1.2.60 远程拒绝服务漏洞预警 Merge pull request !5 from harrylee/master	2019-09-06 13:18:52 +08:00
harrylee	9b4e149953	fix: Fastjson ＜ 1.2.60 远程拒绝服务漏洞预警 link: https://card.weibo.com/article/m/show/id/2309404413257925394542	2019-09-06 11:27:55 +08:00
yadong.zhang	2e16556968	📝 编写文档	2019-09-04 09:44:14 +08:00