WxCpTpService (WxJava - CP Java SDK 4.7.0 API)

所有已知实现类:

BaseWxCpTpServiceImpl, WxCpTpServiceApacheHttpClientImpl, WxCpTpServiceImpl
```
public interface WxCpTpService
```
企业微信第三方应用API的Service.

作者:

zhenjun cai

方法概要

所有方法实例方法抽象方法已过时的方法
限定符和类型	方法和说明
`boolean`	`checkSignature(String msgSignature, String timestamp, String nonce, String data)` 验证推送过来的消息的正确性详情请见: 消息体签名校验
`WxCpTpCorpId2OpenCorpId`	`corpId2OpenCorpId(String corpId)` 明文corpid转换为加密corpid 为更好地保护企业与用户的数据，第三方应用获取的corpid不再是明文的corpid，将升级为第三方服务商级别的加密corpid。
`WxJsapiSignature`	`createAuthCorpJsApiTicketSignature(String url, String authCorpId)` 创建机构级jsApiTicket签名详情参见企业微信第三方应用开发文档
`WxJsapiSignature`	`createSuiteJsApiTicketSignature(String url, String authCorpId)` 创建应用级jsapiTicket签名详情参见：企业微信第三方应用开发文档
`<T,E> T`	`execute(RequestExecutor<T,E> executor, String uri, E data)` Service没有实现某个API的时候，可以用这个，比`get(java.lang.String, java.lang.String)`和`post(java.lang.String, java.lang.String)`方法更灵活，可以自己构造RequestExecutor用来处理不同的参数和不同的返回类型。
`void`	`expireAccessToken(String authCorpId)` 使机构accessToken缓存失效
`void`	`expireAuthCorpJsApiTicket(String authCorpId)` 使机构jsapiticket缓存失效
`void`	`expireAuthSuiteJsApiTicket(String authCorpId)` 使应用jsapiticket失效
`void`	`expireProviderToken()` 使供应商accessToken失效
`void`	`expireSuiteAccessToken()` 使套件accessToken缓存失效
`String`	`get(String url, String queryParam)` 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的GET请求.
`String`	`get(String url, String queryParam, boolean withoutSuiteAccessToken)` 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的GET请求.
`WxCpTpAdmin`	`getAdminList(String authCorpId, Integer agentId)` 获取应用的管理员列表
`WxCpTpAppQrcode`	`getAppQrcode(String suiteId, String appId, String state, Integer style, Integer resultType)` 获取应用二维码
`String`	`getAuthCorpJsApiTicket(String authCorpId)` 获取授权企业的 jsapi ticket
`String`	`getAuthCorpJsApiTicket(String authCorpId, boolean forceRefresh)` 获取授权企业的 jsapi ticket, 支持强制刷新
`WxCpTpAuthInfo`	`getAuthInfo(String authCorpId, String permanentCode)` 获取企业的授权信息
`WxAccessToken`	`getCorpToken(String authCorpId, String permanentCode)` 获取企业凭证
`WxAccessToken`	`getCorpToken(String authCorpId, String permanentCode, boolean forceRefresh)` 获取企业凭证, 支持强制刷新
`WxTpCustomizedAuthUrl`	`getCustomizedAuthUrl(String state, List<String> templateIdList)` 获取带参授权链接查看文档
`WxTpLoginInfo`	`getLoginInfo(String authCode)` 获取登录用户信息文档地址：https://work.weixin.qq.com/api/doc/90001/90143/91125
`WxCpTpCorp`	`getPermanentCode(String authCode)` 已过时。
`WxCpTpPermanentCodeInfo`	`getPermanentCodeInfo(String authCode)` 获取企业永久授权码信息原来的方法实现不全
`String`	`getPreAuthUrl(String redirectUri, String state)` 获取预授权链接
`String`	`getPreAuthUrl(String redirectUri, String state, int authType)` 获取预授权链接，测试环境下使用
`RequestHttp<?,?>`	`getRequestHttp()` http请求对象.
`WxSessionManager`	`getSessionManager()` 获取WxSessionManager 对象
`String`	`getSuiteAccessToken()` 获取suite_access_token, 不强制刷新suite_access_token
`String`	`getSuiteAccessToken(boolean forceRefresh)` 获取suite_access_token，本方法线程安全且在多线程同时刷新时只刷新一次，避免超出2000次/日的调用次数上限另：本service的所有方法都会在suite_access_token过期是调用此方法程序员在非必要情况下尽量不要主动调用此方法详情请见: 文档
`WxAccessToken`	`getSuiteAccessTokenEntity()` 获取suite_access_token和剩余过期时间, 不强制刷新suite_access_token
`WxAccessToken`	`getSuiteAccessTokenEntity(boolean forceRefresh)` 获取suite_access_token和剩余过期时间, 支持强制刷新suite_access_token
`String`	`getSuiteJsApiTicket(String authCorpId)` 获取应用的 jsapi ticket
`String`	`getSuiteJsApiTicket(String authCorpId, boolean forceRefresh)` 获取应用的 jsapi ticket，支持强制刷新
`String`	`getSuiteTicket()` 获得suite_ticket,不强制刷新suite_ticket
`String`	`getSuiteTicket(boolean forceRefresh)` 已过时。由于无法主动刷新，所以这个接口实际已经没有意义，需要在接收企业微信的主动推送后，保存这个ticket
`WxCpTpUserDetail`	`getUserDetail3rd(String userTicket)` 获取访问用户敏感信息文档地址
`WxCpTpUserInfo`	`getUserInfo3rd(String code)` 获取登录/访问用户身份 1、网页授权登录对应的文档 2、企业微信web登录对应的文档
`String`	`getWxCpProviderToken()` 获取服务商providerToken
`WxCpProviderToken`	`getWxCpProviderTokenEntity()` 获取服务商providerToken和剩余过期时间
`WxCpProviderToken`	`getWxCpProviderTokenEntity(boolean forceRefresh)` 获取服务商providerToken和剩余过期时间，支持强制刷新
`WxCpTpConfigStorage`	`getWxCpTpConfigStorage()` 已过时。 storage应该在service内部使用，提供这个接口，容易破坏这个封装
`WxCpTpContactService`	`getWxCpTpContactService()` get contact service
`WxCpTpDepartmentService`	`getWxCpTpDepartmentService()` get department service
`WxCpTpEditionService`	`getWxCpTpEditionService()` 获取应用版本付费版本相关接口服务
`WxCpTpIdConvertService`	`getWxCpTpIdConverService()`
`WxCpTpLicenseService`	`getWxCpTpLicenseService()` get license service
`WxCpTpMediaService`	`getWxCpTpMediaService()` get media service
`WxCpTpOAService`	`getWxCpTpOAService()` get oa service
`WxCpTpOAuth2Service`	`getWxCpTpOAuth2Service()` 构造第三方应用oauth2链接
`WxCpTpOrderService`	`getWxCpTpOrderService()` 获取应用版本付费订单相关接口服务
`WxCpTpUserService`	`getWxCpTpUserService()` get user service
`void`	`initHttp()` 初始化http请求对象
`WxCpMaJsCode2SessionResult`	`jsCode2Session(String jsCode)` 小程序登录凭证校验
`String`	`post(String url, String postData)` 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
`String`	`post(String url, String postData, boolean withoutSuiteAccessToken)` 当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
`void`	`setMaxRetryTimes(int maxRetryTimes)` 设置当微信系统响应系统繁忙时，最大重试次数.
`void`	`setRetrySleepMillis(int retrySleepMillis)` 设置当微信系统响应系统繁忙时，要等待多少 retrySleepMillis(ms) * 2^(重试次数 - 1) 再发起重试.
`void`	`setSuiteTicket(String suiteTicket)` 保存企业微信定时推送的suite_ticket,（每10分钟）详情请见：文档注意：微信不是固定10分钟推送suite_ticket的, 且suite_ticket的有效期为30分钟 https://work.weixin.qq.com/api/doc/10975#%E8%8E%B7%E5%8F%96%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BA%94%E7%94%A8%E5%87%AD%E8%AF%81
`void`	`setSuiteTicket(String suiteTicket, int expiresInSeconds)` 保存企业微信定时推送的suite_ticket,（每10分钟）详情请见：文档注意：微信不是固定10分钟推送suite_ticket的, 且suite_ticket的有效期为30分钟 https://work.weixin.qq.com/api/doc/10975#%E8%8E%B7%E5%8F%96%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BA%94%E7%94%A8%E5%87%AD%E8%AF%81
`void`	`setWxCpTpConfigStorage(WxCpTpConfigStorage wxConfigProvider)` 注入 `WxCpTpConfigStorage` 的实现.
`void`	`setWxCpTpContactService(WxCpTpContactService wxCpTpContactService)` set contact service
`void`	`setWxCpTpDepartmentService(WxCpTpDepartmentService wxCpTpDepartmentService)` set department service
`void`	`setWxCpTpIdConverService(WxCpTpIdConvertService wxCpTpIdConvertService)`
`void`	`setWxCpTpLicenseService(WxCpTpLicenseService wxCpTpLicenseService)` set license service
`void`	`setWxCpTpMediaService(WxCpTpMediaService wxCpTpMediaService)` set media service
`void`	`setWxCpTpOAService(WxCpTpOAService wxCpTpOAService)` set oa service
`void`	`setWxCpTpOAuth2Service(WxCpTpOAuth2Service wxCpTpOAuth2Service)`
`void`	`setWxCpTpOrderService(WxCpTpEditionService wxCpTpEditionService)` 设置应用版本付费版本相关接口服务
`void`	`setWxCpTpOrderService(WxCpTpOrderService wxCpTpOrderService)` 设置应用版本付费订单相关接口服务
`void`	`setWxCpTpUserService(WxCpTpUserService wxCpTpUserService)` set user service

- 方法详细资料
  - checkSignature
```
boolean checkSignature(String msgSignature,
                       String timestamp,
                       String nonce,
                       String data)
```
```
 验证推送过来的消息的正确性
 详情请见: 消息体签名校验
 
```
    参数:
    
    msgSignature - 消息签名
    
    timestamp - 时间戳
    
    nonce - 随机数
    
    data - 微信传输过来的数据，有可能是echoStr，有可能是xml消息
    
    返回:
    
    the boolean
  - getSuiteAccessToken
```
String getSuiteAccessToken()
                    throws WxErrorException
```
    获取suite_access_token, 不强制刷新suite_access_token
    
    返回:
    
    the suite access token
    
    抛出:
    
    WxErrorException - the wx error exception
    
    另请参阅:
    
    #getSuiteAccessToken(boolean)#getSuiteAccessToken(boolean) #getSuiteAccessToken(boolean)
  - getSuiteAccessToken
```
String getSuiteAccessToken(boolean forceRefresh)
                    throws WxErrorException
```
```
 获取suite_access_token，本方法线程安全
 且在多线程同时刷新时只刷新一次，避免超出2000次/日的调用次数上限
 另：本service的所有方法都会在suite_access_token过期是调用此方法
 程序员在非必要情况下尽量不要主动调用此方法
 详情请见: 文档
 
```
    参数:
    
    forceRefresh - 强制刷新
    
    返回:
    
    the suite access token
    
    抛出:
    
    WxErrorException - the wx error exception
  - getSuiteAccessTokenEntity
```
WxAccessToken getSuiteAccessTokenEntity()
                                 throws WxErrorException
```
    获取suite_access_token和剩余过期时间, 不强制刷新suite_access_token
    
    返回:
    
    suite access token and the remaining expiration time
    
    抛出:
    
    WxErrorException - the wx error exception
  - getSuiteAccessTokenEntity
```
WxAccessToken getSuiteAccessTokenEntity(boolean forceRefresh)
                                 throws WxErrorException
```
    获取suite_access_token和剩余过期时间, 支持强制刷新suite_access_token
    
    参数:
    
    forceRefresh - 是否调用微信服务器强制刷新token
    
    返回:
    
    suite access token and the remaining expiration time
    
    抛出:
    
    WxErrorException - the wx error exception
  - getSuiteTicket
```
String getSuiteTicket()
               throws WxErrorException
```
    获得suite_ticket,不强制刷新suite_ticket
    
    返回:
    
    the suite ticket
    
    抛出:
    
    WxErrorException - the wx error exception
    
    另请参阅:
    
    #getSuiteTicket(boolean)#getSuiteTicket(boolean)#getSuiteTicket(boolean)
  - setSuiteTicket
```
void setSuiteTicket(String suiteTicket)
```
```
 保存企业微信定时推送的suite_ticket,（每10分钟）
 详情请见：文档

 注意：微信不是固定10分钟推送suite_ticket的, 且suite_ticket的有效期为30分钟
 https://work.weixin.qq.com/api/doc/10975#%E8%8E%B7%E5%8F%96%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BA%94%E7%94%A8%E5%87%AD%E8%AF%81
 
```
    参数:
    
    suiteTicket - the suite ticket
  - getSuiteTicket
```
@Deprecated
String getSuiteTicket(boolean forceRefresh)
                           throws WxErrorException
```
    已过时。由于无法主动刷新，所以这个接口实际已经没有意义，需要在接收企业微信的主动推送后，保存这个ticket
```
 获得suite_ticket
 由于suite_ticket是微信服务器定时推送（每10分钟），不能主动获取，如果碰到过期只能抛异常

 详情请见：文档
 
```
    参数:
    
    forceRefresh - 强制刷新
    
    返回:
    
    the suite ticket
    
    抛出:
    
    WxErrorException - the wx error exception
    
    另请参阅:
    
    #setSuiteTicket(String)#setSuiteTicket(String)
  - setSuiteTicket
```
void setSuiteTicket(String suiteTicket,
                    int expiresInSeconds)
```
```
 保存企业微信定时推送的suite_ticket,（每10分钟）
 详情请见：文档

 注意：微信不是固定10分钟推送suite_ticket的, 且suite_ticket的有效期为30分钟
 https://work.weixin.qq.com/api/doc/10975#%E8%8E%B7%E5%8F%96%E7%AC%AC%E4%B8%89%E6%96%B9%E5%BA%94%E7%94%A8%E5%87%AD%E8%AF%81
 
```
    参数:
    
    suiteTicket - the suite ticket
    
    expiresInSeconds - the expires in seconds
  - getSuiteJsApiTicket
```
String getSuiteJsApiTicket(String authCorpId)
                    throws WxErrorException
```
    获取应用的 jsapi ticket
    
    参数:
    
    authCorpId - 授权企业的cropId
    
    返回:
    
    jsapi ticket
    
    抛出:
    
    WxErrorException - the wx error exception
  - getSuiteJsApiTicket
```
String getSuiteJsApiTicket(String authCorpId,
                           boolean forceRefresh)
                    throws WxErrorException
```
    获取应用的 jsapi ticket，支持强制刷新
    
    参数:
    
    authCorpId - the auth corp id
    
    forceRefresh - the force refresh
    
    返回:
    
    suite js api ticket
    
    抛出:
    
    WxErrorException - the wx error exception
  - jsCode2Session
```
WxCpMaJsCode2SessionResult jsCode2Session(String jsCode)
                                   throws WxErrorException
```
    小程序登录凭证校验
    
    参数:
    
    jsCode - 登录时获取的 code
    
    返回:
    
    the wx cp ma js code 2 session result
    
    抛出:
    
    WxErrorException - the wx error exception
  - getCorpToken
```
WxAccessToken getCorpToken(String authCorpId,
                           String permanentCode)
                    throws WxErrorException
```
    获取企业凭证
    
    参数:
    
    authCorpId - 授权方corpid
    
    permanentCode - 永久授权码，通过get_permanent_code获取
    
    返回:
    
    the corp token
    
    抛出:
    
    WxErrorException - the wx error exception
  - getCorpToken
```
WxAccessToken getCorpToken(String authCorpId,
                           String permanentCode,
                           boolean forceRefresh)
                    throws WxErrorException
```
    获取企业凭证, 支持强制刷新
    
    参数:
    
    authCorpId - the auth corp id
    
    permanentCode - the permanent code
    
    forceRefresh - the force refresh
    
    返回:
    
    corp token
    
    抛出:
    
    WxErrorException - the wx error exception
  - getPermanentCode
```
@Deprecated
WxCpTpCorp getPermanentCode(String authCode)
                                 throws WxErrorException
```
    已过时。
    
    获取企业永久授权码 .
    
    参数:
    
    authCode - .
    
    返回:
    
    . permanent code
    
    抛出:
    
    WxErrorException - the wx error exception
  - getPermanentCodeInfo
```
WxCpTpPermanentCodeInfo getPermanentCodeInfo(String authCode)
                                      throws WxErrorException
```
    获取企业永久授权码信息
```
   原来的方法实现不全
 
```
    参数:
    
    authCode - the auth code
    
    返回:
    
    permanent code info
    
    抛出:
    
    WxErrorException - the wx error exception
    
    从以下版本开始:
    
    2020 -03-18
  - getPreAuthUrl
```
String getPreAuthUrl(String redirectUri,
                     String state)
              throws WxErrorException
```
```
   获取预授权链接
 
```
    参数:
    
    redirectUri - 授权完成后的回调网址
    
    state - a-zA-Z0-9的参数值（不超过128个字节），用于第三方自行校验session，防止跨域攻击
    
    返回:
    
    pre auth url
    
    抛出:
    
    WxErrorException - the wx error exception
  - getPreAuthUrl
```
String getPreAuthUrl(String redirectUri,
                     String state,
                     int authType)
              throws WxErrorException
```
```
   获取预授权链接，测试环境下使用
 
```
    参数:
    
    redirectUri - 授权完成后的回调网址
    
    state - a-zA-Z0-9的参数值（不超过128个字节），用于第三方自行校验session，防止跨域攻击
    
    authType - 授权类型：0 正式授权， 1 测试授权。
    
    返回:
    
    pre auth url
    
    抛出:
    
    WxErrorException - the wx error exception
  - getAuthInfo
```
WxCpTpAuthInfo getAuthInfo(String authCorpId,
                           String permanentCode)
                    throws WxErrorException
```
    获取企业的授权信息
    
    参数:
    
    authCorpId - 授权企业的corpId
    
    permanentCode - 授权企业的永久授权码
    
    返回:
    
    auth info
    
    抛出:
    
    WxErrorException - the wx error exception
  - getAuthCorpJsApiTicket
```
String getAuthCorpJsApiTicket(String authCorpId)
                       throws WxErrorException
```
    获取授权企业的 jsapi ticket
    
    参数:
    
    authCorpId - 授权企业的cropId
    
    返回:
    
    jsapi ticket
    
    抛出:
    
    WxErrorException - the wx error exception
  - getAuthCorpJsApiTicket
```
String getAuthCorpJsApiTicket(String authCorpId,
                              boolean forceRefresh)
                       throws WxErrorException
```
    获取授权企业的 jsapi ticket, 支持强制刷新
    
    参数:
    
    authCorpId - the auth corp id
    
    forceRefresh - the force refresh
    
    返回:
    
    auth corp js api ticket
    
    抛出:
    
    WxErrorException - the wx error exception
  - get
```
String get(String url,
           String queryParam)
    throws WxErrorException
```
    当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的GET请求.
    
    参数:
    
    url - 接口地址
    
    queryParam - 请求参数
    
    返回:
    
    the string
    
    抛出:
    
    WxErrorException - the wx error exception
  - get
```
String get(String url,
           String queryParam,
           boolean withoutSuiteAccessToken)
    throws WxErrorException
```
    当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的GET请求.
    
    参数:
    
    url - 接口地址
    
    queryParam - 请求参数
    
    withoutSuiteAccessToken - 请求是否忽略SuiteAccessToken 默认不忽略-false
    
    返回:
    
    the string
    
    抛出:
    
    WxErrorException - the wx error exception
  - post
```
String post(String url,
            String postData)
     throws WxErrorException
```
    当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
    
    参数:
    
    url - 接口地址
    
    postData - 请求body字符串
    
    返回:
    
    the string
    
    抛出:
    
    WxErrorException - the wx error exception
  - post
```
String post(String url,
            String postData,
            boolean withoutSuiteAccessToken)
     throws WxErrorException
```
    当本Service没有实现某个API的时候，可以用这个，针对所有微信API中的POST请求.
    
    参数:
    
    url - 接口地址
    
    postData - 请求body字符串
    
    withoutSuiteAccessToken - 请求是否忽略SuiteAccessToken 默认不忽略-false
    
    返回:
    
    the string
    
    抛出:
    
    WxErrorException - the wx error exception
  - execute
```
<T,E> T execute(RequestExecutor<T,E> executor,
                String uri,
                E data)
         throws WxErrorException
```
```
 Service没有实现某个API的时候，可以用这个，
 比get(java.lang.String, java.lang.String)和post(java.lang.String, java.lang.String)方法更灵活，可以自己构造RequestExecutor用来处理不同的参数和不同的返回类型。
 可以参考，MediaUploadRequestExecutor的实现方法
 
```
    类型参数:
    
    T - 请求值类型
    
    E - 返回值类型
    
    参数:
    
    executor - 执行器
    
    uri - 请求地址
    
    data - 参数
    
    返回:
    
    the t
    
    抛出:
    
    WxErrorException - the wx error exception
  - setRetrySleepMillis
```
void setRetrySleepMillis(int retrySleepMillis)
```
```
 设置当微信系统响应系统繁忙时，要等待多少 retrySleepMillis(ms) * 2^(重试次数 - 1) 再发起重试.
 默认：1000ms
 
```
    参数:
    
    retrySleepMillis - 重试休息时间
  - setMaxRetryTimes
```
void setMaxRetryTimes(int maxRetryTimes)
```
```
 设置当微信系统响应系统繁忙时，最大重试次数.
 默认：5次
 
```
    参数:
    
    maxRetryTimes - 最大重试次数
  - initHttp
```
void initHttp()
```
    初始化http请求对象
  - getWxCpTpConfigStorage
```
@Deprecated
WxCpTpConfigStorage getWxCpTpConfigStorage()
```
    已过时。 storage应该在service内部使用，提供这个接口，容易破坏这个封装
    
    获取WxCpTpConfigStorage 对象.
    
    返回:
    
    WxCpTpConfigStorage wx cp tp config storage
  - setWxCpTpConfigStorage
```
void setWxCpTpConfigStorage(WxCpTpConfigStorage wxConfigProvider)
```
    注入 WxCpTpConfigStorage 的实现.
    
    参数:
    
    wxConfigProvider - 配置对象
  - getRequestHttp
```
RequestHttp<?,?> getRequestHttp()
```
    http请求对象.
    
    返回:
    
    the request http
  - getSessionManager
```
WxSessionManager getSessionManager()
```
    获取WxSessionManager 对象
    
    返回:
    
    WxSessionManager session manager
  - getUserInfo3rd
```
WxCpTpUserInfo getUserInfo3rd(String code)
                       throws WxErrorException
```
```
 获取登录/访问用户身份
 1、网页授权登录对应的文档
 2、企业微信web登录对应的文档
 
```
    参数:
    
    code - the code
    
    返回:
    
    user info 3 rd
    
    抛出:
    
    WxErrorException - the wx error exception
  - getUserDetail3rd
```
WxCpTpUserDetail getUserDetail3rd(String userTicket)
                           throws WxErrorException
```
```
 获取访问用户敏感信息
 文档地址
 
```
    参数:
    
    userTicket - the user ticket
    
    返回:
    
    user detail 3 rd
    
    抛出:
    
    WxErrorException - the wx error exception
  - getLoginInfo
```
WxTpLoginInfo getLoginInfo(String authCode)
                    throws WxErrorException
```
    获取登录用户信息
    文档地址：https://work.weixin.qq.com/api/doc/90001/90143/91125
    
    参数:
    
    authCode - the auth code
    
    返回:
    
    login info
    
    抛出:
    
    WxErrorException - the wx error exception
  - getCustomizedAuthUrl
```
WxTpCustomizedAuthUrl getCustomizedAuthUrl(String state,
                                           List<String> templateIdList)
                                    throws WxErrorException
```
    获取带参授权链接
    查看文档
    
    参数:
    
    state - state
    
    templateIdList - 代开发自建应用模版ID列表，数量不能超过9个
    
    返回:
    
    customized auth url
    
    抛出:
    
    WxErrorException - the wx error exception
  - getWxCpProviderToken
```
String getWxCpProviderToken()
                     throws WxErrorException
```
    获取服务商providerToken
    
    返回:
    
    the wx cp provider token
    
    抛出:
    
    WxErrorException - the wx error exception
  - getWxCpProviderTokenEntity
```
WxCpProviderToken getWxCpProviderTokenEntity()
                                      throws WxErrorException
```
    获取服务商providerToken和剩余过期时间
    
    返回:
    
    wx cp provider token entity
    
    抛出:
    
    WxErrorException - the wx error exception
  - getWxCpProviderTokenEntity
```
WxCpProviderToken getWxCpProviderTokenEntity(boolean forceRefresh)
                                      throws WxErrorException
```
    获取服务商providerToken和剩余过期时间，支持强制刷新
    
    参数:
    
    forceRefresh - the force refresh
    
    返回:
    
    wx cp provider token entity
    
    抛出:
    
    WxErrorException - the wx error exception
  - getWxCpTpContactService
```
WxCpTpContactService getWxCpTpContactService()
```
    get contact service
    
    返回:
    
    WxCpTpContactService wx cp tp contact service
  - setWxCpTpContactService
```
void setWxCpTpContactService(WxCpTpContactService wxCpTpContactService)
```
    set contact service
    
    参数:
    
    wxCpTpContactService - the contact service
  - getWxCpTpDepartmentService
```
WxCpTpDepartmentService getWxCpTpDepartmentService()
```
    get department service
    
    返回:
    
    WxCpTpDepartmentService wx cp tp department service
  - setWxCpTpDepartmentService
```
void setWxCpTpDepartmentService(WxCpTpDepartmentService wxCpTpDepartmentService)
```
    set department service
    
    参数:
    
    wxCpTpDepartmentService - the department service
  - getWxCpTpMediaService
```
WxCpTpMediaService getWxCpTpMediaService()
```
    get media service
    
    返回:
    
    WxCpTpMediaService wx cp tp media service
  - setWxCpTpMediaService
```
void setWxCpTpMediaService(WxCpTpMediaService wxCpTpMediaService)
```
    set media service
    
    参数:
    
    wxCpTpMediaService - the media service
  - getWxCpTpOAService
```
WxCpTpOAService getWxCpTpOAService()
```
    get oa service
    
    返回:
    
    WxCpTpOAService wx cp tp oa service
  - setWxCpTpOAService
```
void setWxCpTpOAService(WxCpTpOAService wxCpTpOAService)
```
    set oa service
    
    参数:
    
    wxCpTpOAService - the oa service
  - getWxCpTpUserService
```
WxCpTpUserService getWxCpTpUserService()
```
    get user service
    
    返回:
    
    WxCpTpUserService wx cp tp user service
  - setWxCpTpUserService
```
void setWxCpTpUserService(WxCpTpUserService wxCpTpUserService)
```
    set user service
    
    参数:
    
    wxCpTpUserService - the set user service
  - setWxCpTpLicenseService
```
void setWxCpTpLicenseService(WxCpTpLicenseService wxCpTpLicenseService)
```
    set license service
    
    参数:
    
    wxCpTpLicenseService - the oa service
  - getWxCpTpLicenseService
```
WxCpTpLicenseService getWxCpTpLicenseService()
```
    get license service
    
    返回:
    
    getCpTPLicenseService wx cp tp license service
  - getAdminList
```
WxCpTpAdmin getAdminList(String authCorpId,
                         Integer agentId)
                  throws WxErrorException
```
    获取应用的管理员列表
    
    参数:
    
    authCorpId - the auth corp id
    
    agentId - the agent id
    
    返回:
    
    admin list
    
    抛出:
    
    WxErrorException - the wx error exception
  - getAppQrcode
```
WxCpTpAppQrcode getAppQrcode(String suiteId,
                             String appId,
                             String state,
                             Integer style,
                             Integer resultType)
                      throws WxErrorException
```
    获取应用二维码
    
    参数:
    
    suiteId - 第三方应用id（即ww或wx开头的suiteid）
    
    appId - 第三方应用id，单应用不需要该参数，多应用旧套件才需要传该参数。若不传默认为1
    
    state - state值，用于区分不同的安装渠道
    
    style - 二维码样式选项，默认为不带说明外框小尺寸。0：带说明外框的二维码，适合于实体物料，1：带说明外框的二维码，适合于屏幕类，2：不带说明外框（小尺寸），3：不带说明外框（中尺寸），4：不带说明外框（大尺寸）。具体样式与服务商管理端获取到的应用二维码样式一一对应，参见下文二维码样式说明
    
    resultType - 结果返回方式，默认为返回二维码图片buffer。1：二维码图片buffer，2：二维码图片url
    
    返回:
    
    二维码
    
    抛出:
    
    WxErrorException - the wx error exception
  - corpId2OpenCorpId
```
WxCpTpCorpId2OpenCorpId corpId2OpenCorpId(String corpId)
                                   throws WxErrorException
```
    明文corpid转换为加密corpid 为更好地保护企业与用户的数据，第三方应用获取的corpid不再是明文的corpid，将升级为第三方服务商级别的加密corpid。文档说明第三方可以将已有的明文corpid转换为第三方的加密corpid。
    
    参数:
    
    corpId -
    
    返回:
    
    抛出:
    
    WxErrorException
  - createAuthCorpJsApiTicketSignature
```
WxJsapiSignature createAuthCorpJsApiTicketSignature(String url,
                                                    String authCorpId)
                                             throws WxErrorException
```
    创建机构级jsApiTicket签名详情参见企业微信第三方应用开发文档
    
    参数:
    
    url - 调用JS接口页面的完整URL
    
    authCorpId - the auth corp id
    
    返回:
    
    wx jsapi signature
    
    抛出:
    
    WxErrorException - the wx error exception
  - createSuiteJsApiTicketSignature
```
WxJsapiSignature createSuiteJsApiTicketSignature(String url,
                                                 String authCorpId)
                                          throws WxErrorException
```
    创建应用级jsapiTicket签名详情参见：企业微信第三方应用开发文档
    
    参数:
    
    url - 调用JS接口页面的完整URL
    
    authCorpId - the auth corp id
    
    返回:
    
    wx jsapi signature
    
    抛出:
    
    WxErrorException - the wx error exception
  - expireSuiteAccessToken
```
void expireSuiteAccessToken()
```
    使套件accessToken缓存失效
  - expireAccessToken
```
void expireAccessToken(String authCorpId)
```
    使机构accessToken缓存失效
    
    参数:
    
    authCorpId - 机构id
  - expireAuthCorpJsApiTicket
```
void expireAuthCorpJsApiTicket(String authCorpId)
```
    使机构jsapiticket缓存失效
    
    参数:
    
    authCorpId - 机构id
  - expireAuthSuiteJsApiTicket
```
void expireAuthSuiteJsApiTicket(String authCorpId)
```
    使应用jsapiticket失效
    
    参数:
    
    authCorpId - 机构id
  - expireProviderToken
```
void expireProviderToken()
```
    使供应商accessToken失效
  - getWxCpTpOrderService
```
WxCpTpOrderService getWxCpTpOrderService()
```
    获取应用版本付费订单相关接口服务
    
    返回:
    
    the wx cp tp order service
  - setWxCpTpOrderService
```
void setWxCpTpOrderService(WxCpTpOrderService wxCpTpOrderService)
```
    设置应用版本付费订单相关接口服务
    
    参数:
    
    wxCpTpOrderService - the wx cp tp order service
  - getWxCpTpEditionService
```
WxCpTpEditionService getWxCpTpEditionService()
```
    获取应用版本付费版本相关接口服务
    
    返回:
    
    the wx cp tp edition service
  - setWxCpTpOrderService
```
void setWxCpTpOrderService(WxCpTpEditionService wxCpTpEditionService)
```
    设置应用版本付费版本相关接口服务
    
    参数:
    
    wxCpTpEditionService - the wx cp tp edition service
  - getWxCpTpIdConverService
```
WxCpTpIdConvertService getWxCpTpIdConverService()
```
  - setWxCpTpIdConverService
```
void setWxCpTpIdConverService(WxCpTpIdConvertService wxCpTpIdConvertService)
```
  - getWxCpTpOAuth2Service
```
WxCpTpOAuth2Service getWxCpTpOAuth2Service()
```
    构造第三方应用oauth2链接
  - setWxCpTpOAuth2Service
```
void setWxCpTpOAuth2Service(WxCpTpOAuth2Service wxCpTpOAuth2Service)
```

接口 WxCpTpService

方法概要

方法详细资料

checkSignature

getSuiteAccessToken

getSuiteAccessToken

getSuiteAccessTokenEntity

getSuiteAccessTokenEntity

getSuiteTicket

setSuiteTicket

getSuiteTicket

setSuiteTicket

getSuiteJsApiTicket

getSuiteJsApiTicket

jsCode2Session

getCorpToken

getCorpToken

getPermanentCode

getPermanentCodeInfo

getPreAuthUrl

getPreAuthUrl

getAuthInfo

getAuthCorpJsApiTicket

getAuthCorpJsApiTicket

get

get

post

post

execute

setRetrySleepMillis

setMaxRetryTimes

initHttp

getWxCpTpConfigStorage

setWxCpTpConfigStorage

getRequestHttp

getSessionManager

getUserInfo3rd

getUserDetail3rd

getLoginInfo

getCustomizedAuthUrl

getWxCpProviderToken

getWxCpProviderTokenEntity

getWxCpProviderTokenEntity

getWxCpTpContactService

setWxCpTpContactService

getWxCpTpDepartmentService

setWxCpTpDepartmentService

getWxCpTpMediaService

setWxCpTpMediaService

getWxCpTpOAService

setWxCpTpOAService

getWxCpTpUserService

setWxCpTpUserService

setWxCpTpLicenseService

getWxCpTpLicenseService

getAdminList

getAppQrcode

corpId2OpenCorpId

createAuthCorpJsApiTicketSignature

createSuiteJsApiTicketSignature

expireSuiteAccessToken

expireAccessToken

expireAuthCorpJsApiTicket

expireAuthSuiteJsApiTicket

expireProviderToken

getWxCpTpOrderService

setWxCpTpOrderService

getWxCpTpEditionService

setWxCpTpOrderService

getWxCpTpIdConverService

setWxCpTpIdConverService

getWxCpTpOAuth2Service

setWxCpTpOAuth2Service