OauthApi (weixin4j-qy 1.10.1 API)

java.lang.Object
- com.foxinmy.weixin4j.api.BaseApi
- - com.foxinmy.weixin4j.qy.api.QyApi
  - - com.foxinmy.weixin4j.qy.api.OauthApi

```
public class OauthApi
extends QyApi
```
企业号oauth授权

Since:

JDK 1.6

Author:

jinyu(foxinmy@gmail.com)

See Also:

企业号用户身份授权说明, 企业号第三方提供商授权说明, 企业号第三方套件应用授权说明

Field Summary
- Fields inherited from class com.foxinmy.weixin4j.api.BaseApi
  weixinExecutor

Constructor Summary

Constructors
Constructor	Description
`OauthApi()`	默认使用weixin4j.properties里面的corpid、corpsecret信息
`OauthApi(com.foxinmy.weixin4j.model.WeixinAccount account)`	传入corpid、appsecret信息

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`String`	`getThirdAuthorizationURL()`	企业号第三方提供商登陆授权 redirectUri默认填写weixin4j.properties#third.oauth.redirect.uri state默认填写state
`String`	`getUserAuthorizationURL()`	企业号成员身份授权 redirectUri默认填写weixin4j.properties#user.oauth.redirect.uri state默认填写state
`String`	`getUserAuthorizationURL(String redirectUri, String scope, String state, Integer agentId)`	企业号成员身份授权
`String`	`getUserThirdAuthorizationURL(String redirectUri, String state, String userType)`	企业号成员登陆授权

Methods inherited from class com.foxinmy.weixin4j.qy.api.QyApi
weixinBundle

Methods inherited from class com.foxinmy.weixin4j.api.BaseApi
getRequestUri

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - OauthApi
```
public OauthApi()
```
    默认使用weixin4j.properties里面的corpid、corpsecret信息
  - OauthApi
```
public OauthApi(com.foxinmy.weixin4j.model.WeixinAccount account)
```
    传入corpid、appsecret信息
    
    Parameters:
    
    account -
- Method Detail
  - getUserAuthorizationURL
```
public String getUserAuthorizationURL()
```
    企业号成员身份授权
  - redirectUri默认填写weixin4j.properties#user.oauth.redirect.uri
  - state默认填写state

Returns:: 请求授权的URL

getUserAuthorizationURL
```
public String getUserAuthorizationURL(String redirectUri,
                                      String scope,
                                      String state,
                                      Integer agentId)
```
企业号成员身份授权

Parameters:

redirectUri - 重定向地址

scope - 应用授权作用域。 snsapi_base：静默授权，可获取成员的基础信息；
snsapi_userinfo：静默授权，可获取成员的详细信息，但不包含手机、邮箱；
snsapi_privateinfo：手动授权，可获取成员的详细信息，包含手机、邮箱。

state - 用于保持请求和回调的状态

agentId - 企业应用的id。当scope是snsapi_userinfo或snsapi_privateinfo时，该参数必填。注意redirect_uri的域名必须与该应用的可信域名一致。

Returns:

请求授权的URL

See Also:

UserApi#getOUserInfoByCode(String, String), 企业号用户身份授权

getThirdAuthorizationURL
```
public String getThirdAuthorizationURL()
```
企业号第三方提供商登陆授权
redirectUri默认填写weixin4j.properties#third.oauth.redirect.uri
state默认填写state

Returns:: 请求授权的URL

getUserThirdAuthorizationURL
```
public String getUserThirdAuthorizationURL(String redirectUri,
                                           String state,
                                           String userType)
```
企业号成员登陆授权

Parameters:

corpId - 服务商的CorpID或者企业的CorpID

redirectUri - 重定向地址

state - 用于保持请求和回调的状态，授权请求后原样带回给第三方

userType - redirect_uri支持登录的类型，有member(成员登录)、admin(管理员登录)、all(成员或管理员皆可登录) ，默认值为admin

Returns:

请求授权的URL

See Also:

授权登录服务商的网站时，使用应用提供商的provider_access_token;, 授权登录企业的网站时，使用企业管理组的access_token, 企业号第三方提供商授权