JustAuth/docs/README.md

Login, so easy!

史上最全的整合第三方登录的开源库

开源地址： Gitee | Github

QQ群：230017570

文档更新日期： {docsify-updated}

简介

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

特点

废话不多说，就俩字：

1. 全：已集成十多家第三方平台（国内外常用的基本都已包含），后续依然还有扩展计划！
2. 简：API就是奔着最简单去设计的，尽量让您用起来没有障碍感！

已集成的平台

💻 平台	☕ API类	📄 SDK
	AuthGiteeRequest	参考文档
	AuthGithubRequest	参考文档
	AuthWeiboRequest	参考文档
	AuthDingTalkRequest	参考文档
	AuthBaiduRequest	参考文档
	AuthCodingRequest	参考文档
	AuthTencentCloudRequest	参考文档
	AuthOschinaRequest	参考文档
	AuthAlipayRequest	参考文档
	AuthQqRequest	参考文档
	AuthWeChatRequest	参考文档
	AuthTaobaoRequest	参考文档
	AuthGoogleRequest	参考文档
	AuthFacebookRequest	参考文档
	AuthDouyinRequest	参考文档
	AuthLinkedinRequest	参考文档
	AuthMicrosoftRequest	参考文档
	AuthMiRequest	参考文档
	AuthToutiaoRequest	参考文档
	AuthTeambitionRequest	参考文档
	AuthRenrenRequest	参考文档
	AuthPinterestRequest	参考文档
	AuthStackOverflowRequest	参考文档
	AuthCsdnRequest	无

快速开始

• 引入依赖

<dependency>
    <groupId>me.zhyd.oauth</groupId>
    <artifactId>JustAuth</artifactId>
    <version>1.10.0</version>
</dependency>

• 调用api

// 创建授权request
AuthRequest authRequest = new AuthGiteeRequest(AuthConfig.builder()
        .clientId("clientId")
        .clientSecret("clientSecret")
        .redirectUri("redirectUri")
        .build());
// 生成授权页面
authRequest.authorize();
// 授权登录后会返回code（auth_code（仅限支付宝））、state，1.8.0版本后，可以用AuthCallback类作为回调接口的参数
// 注：JustAuth默认保存state的时效为3分钟，3分钟内未使用则会自动清除过期的state
authRequest.login(callback);

贡献代码

1. fork本项目到自己的repo
2. 把fork过去的项目也就是你仓库中的项目clone到你的本地
3. 修改代码
4. commit后push到自己的库
5. 发起PR（pull request） 请求，提交到dev分支
6. 等待作者合并

注：JustAuth只接受集成oauth2.0的平台

关于功能尝鲜

JustAuth一共有两个主要分支：

• 线上版分支（master）：稳定版，发布版就是这个分支的代码
• 开发版分支（dev）：不保证稳定，新功能都会优先推送到该分支，对于想尝鲜的朋友，可以直接下载代码，然后源码编译dev分支

捐赠

支付宝	微信