xiongwei.jiang.service.impl

类 WXWorkServiceImpl

java.lang.Object

xiongwei.jiang.service.impl.WXWorkServiceImpl

所有已实现的接口:

org.springframework.beans.factory.InitializingBean, WXWorkService

@EnableConfigurationProperties(value=WXWorkProperties.class)
 @EnableRetry
 @Service
public class WXWorkServiceImpl
extends Object
implements WXWorkService, org.springframework.beans.factory.InitializingBean

企业微信服务接口实现类

作者:

天之蓝

字段概要

字段

限定符和类型	字段和说明
static com.fasterxml.jackson.databind.ObjectMapper	OBJECT_MAPPER

构造器概要

构造器

构造器和说明
WXWorkServiceImpl()

方法概要

限定符和类型	方法和说明
void	afterPropertiesSet()
Map<String,Object>	callback(int callbackIndex, String msg_signature, String timestamp, String nonce, String xml, javax.servlet.http.HttpServletResponse response) 企业内部开发 > 服务端API > 开发指南 > 回调配置 > 支持Http Post请求接收业务数据
byte[]	downloadTemp(int appIndex, String mediaId) 企业内部开发 > 服务端API > 素材管理 > 获取临时素材
byte[]	downloadVoice(int appIndex, String mediaId) 企业内部开发 > 服务端API > 素材管理 > 获取高清语音素材
String	get(int appIndex, URI url)
Map<String,Object>	getAppConfig(int appIndex, String webUrl) 企业内部开发 > 客户端API > JS-SDK > 基础接口 > wx.agentConfig > 通过agentConfig注入应用的权限
String	getAppTicket(int appIndex) 企业内部开发 > 客户端API > JS-SDK > 附录 > JS-SDK使用权限签名算法 > 获取应用的jsapi_ticket
String	getAppTicketCache(int appIndex) 企业内部开发 > 客户端API > JS-SDK > 附录 > JS-SDK使用权限签名算法 > 获取应用的jsapi_ticket
String	getAuth(int appIndex, URI url)
CheckinRecord	getCheckinRecord(int openCheckinDataType, long startTime, long endTime, List<String> userIdList) 企业内部开发 > 服务端API > OA > 打卡 > 获取打卡记录数据
Map<String,Object>	getCorpConfig(int appIndex, String webUrl) 企业内部开发 > 客户端API > JS-SDK > 开始开发 > 使用说明 > 通过config接口注入权限验证配置
String	getCorpTicket(int appIndex) 企业内部开发 > 客户端API > JS-SDK > 附录 > JS-SDK使用权限签名算法 > 获取企业的jsapi_ticket
String	getCorpTicketCache(int appIndex) 企业内部开发 > 客户端API > JS-SDK > 附录 > JS-SDK使用权限签名算法 > 获取企业的jsapi_ticket
DepartmentList	getDepartmentList(int appIndex, int departmentId) 企业内部开发 > 服务端API > 通讯录管理 > 部门管理 > 获取部门列表
DepartmentUser	getDepartmentUser(int appIndex, int departmentId, int fetchChild) 企业内部开发 > 服务端API > 通讯录管理 > 成员管理 > 获取部门成员
TagList	getTagList() 企业内部开发 > 服务端API > 通讯录管理 > 标签管理 > 获取标签列表
TagUser	getTagUser(int tagId) 企业内部开发 > 服务端API > 通讯录管理 > 标签管理 > 获取标签成员
String	getToken(int appIndex) 企业内部开发 > 服务端API > 开发指南 > 获取access_token
String	getTokenCache(int appIndex) 企业内部开发 > 服务端API > 开发指南 > 获取access_token
User	getUser(int appIndex, String code) 企业内部开发 > 服务端API > 身份验证 > 网页授权登录 > 获取访问用户身份
UserInfo	getUserInfo(int appIndex, String userId) 企业内部开发 > 服务端API > 通讯录管理 > 成员管理 > 读取成员
byte[]	post(int appIndex, URI url)
String	post(int appIndex, URI url, Object body)
String	post(int appIndex, URI url, String filePath)
AppMsg	sendAppMarkdownMsg(int appIndex, AppMarkdownMsg object) 企业内部开发 > 服务端API > 消息推送 > 发送应用消息 > markdown消息
AppMsg	sendAppTextMsg(int appIndex, AppTextMsg object) 企业内部开发 > 服务端API > 消息推送 > 发送应用消息 > 文本消息
BotMsg	sendBotMarkdownMsg(int botIndex, BotMarkdownMsg object) 企业内部开发 > 客户端API > 群机器人 > 群机器人配置说明 > markdown类型
BotMsg	sendBotTextMsg(int botIndex, BotTextMsg object) 企业内部开发 > 客户端API > 群机器人 > 群机器人配置说明 > 文本类型
UploadImage	uploadImage(int appIndex, String filePath) 企业内部开发 > 服务端API > 素材管理 > 上传图片
UploadTemp	uploadTemp(int appIndex, UploadTempType tempType, String filePath) 企业内部开发 > 服务端API > 素材管理 > 上传临时素材
void	verifyUrl(int callbackIndex, String msg_signature, String timestamp, String nonce, String echostr, javax.servlet.http.HttpServletResponse response) 企业内部开发 > 服务端API > 开发指南 > 回调配置 > 支持Http Get请求验证URL有效性

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

OBJECT_MAPPER

public static final com.fasterxml.jackson.databind.ObjectMapper OBJECT_MAPPER

构造器详细资料

WXWorkServiceImpl

public WXWorkServiceImpl()

方法详细资料

afterPropertiesSet

public void afterPropertiesSet()

指定者:

afterPropertiesSet 在接口中 org.springframework.beans.factory.InitializingBean

getToken

public String getToken(int appIndex)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 开发指南 > 获取access_token

指定者:

getToken 在接口中 WXWorkService

参数:

appIndex - 索引

返回:

访问令牌

getTokenCache

public String getTokenCache(int appIndex)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 开发指南 > 获取access_token

指定者:

getTokenCache 在接口中 WXWorkService

参数:

appIndex - 索引

返回:

访问令牌

另请参阅:

WXWorkService.getToken(int)

verifyUrl

public void verifyUrl(int callbackIndex,
                      String msg_signature,
                      String timestamp,
                      String nonce,
                      String echostr,
                      javax.servlet.http.HttpServletResponse response)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 开发指南 > 回调配置 > 支持Http Get请求验证URL有效性

指定者:

verifyUrl 在接口中 WXWorkService

参数:

callbackIndex - 索引

msg_signature - 企业微信加密签名，msg_signature计算结合了企业填写的token、请求中的timestamp、nonce、加密的消息体

timestamp - 时间戳（与nonce结合使用，用于防止请求重放攻击）

nonce - 随机数（与timestamp结合使用，用于防止请求重放攻击）

echostr - 加密的字符串（需要解密得到消息内容明文，解密后有random、msg_len、msg、receiveid四个字段，其中msg即为消息内容明文）

response - 响应

callback

public Map<String,Object> callback(int callbackIndex,
                                   String msg_signature,
                                   String timestamp,
                                   String nonce,
                                   String xml,
                                   javax.servlet.http.HttpServletResponse response)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 开发指南 > 回调配置 > 支持Http Post请求接收业务数据

指定者:

callback 在接口中 WXWorkService

参数:

callbackIndex - 索引

msg_signature - 企业微信加密签名，msg_signature结合了企业填写的token、请求中的timestamp、nonce参数、加密的消息体

timestamp - 时间戳（与nonce结合使用，用于防止请求重放攻击）

nonce - 随机数（与timestamp结合使用，用于防止请求重放攻击）

xml - 回调数据（放在 HTTP 请求体中，使用注解 RequestBody 接收）

response - 响应

返回:

Map

getUserInfo

public UserInfo getUserInfo(int appIndex,
                            String userId)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 通讯录管理 > 成员管理 > 读取成员

指定者:

getUserInfo 在接口中 WXWorkService

参数:

appIndex - 索引

userId - 工号

返回:

UserInfo

getDepartmentUser

public DepartmentUser getDepartmentUser(int appIndex,
                                        int departmentId,
                                        int fetchChild)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 通讯录管理 > 成员管理 > 获取部门成员

指定者:

getDepartmentUser 在接口中 WXWorkService

参数:

appIndex - 索引

departmentId - 部门 id

fetchChild - 是否递归获取子部门下面的成员（1-递归获取，0-只获取本部门）

返回:

DepartmentUser

getDepartmentList

public DepartmentList getDepartmentList(int appIndex,
                                        int departmentId)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 通讯录管理 > 部门管理 > 获取部门列表

指定者:

getDepartmentList 在接口中 WXWorkService

参数:

appIndex - 索引

departmentId - 部门 id，获取指定部门及其下的子部门（以及子部门的子部门等等，递归）；如果不填，默认获取全量组织架构

返回:

DepartmentList

getTagUser

public TagUser getTagUser(int tagId)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 通讯录管理 > 标签管理 > 获取标签成员

指定者:

getTagUser 在接口中 WXWorkService

参数:

tagId - 标签 id

返回:

TagUser

getTagList

public TagList getTagList()

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 通讯录管理 > 标签管理 > 获取标签列表

指定者:

getTagList 在接口中 WXWorkService

返回:

TagList

getUser

public User getUser(int appIndex,
                    String code)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 身份验证 > 网页授权登录 > 获取访问用户身份

指定者:

getUser 在接口中 WXWorkService

参数:

appIndex - 索引

code - 企业微信授权码，仅可使用一次，5 分钟内有效

返回:

User

sendAppTextMsg

public AppMsg sendAppTextMsg(int appIndex,
                             AppTextMsg object)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 消息推送 > 发送应用消息 > 文本消息

指定者:

sendAppTextMsg 在接口中 WXWorkService

参数:

appIndex - 索引

object - AppTextMsg

返回:

AppMsg

sendAppMarkdownMsg

public AppMsg sendAppMarkdownMsg(int appIndex,
                                 AppMarkdownMsg object)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 消息推送 > 发送应用消息 > markdown消息

指定者:

sendAppMarkdownMsg 在接口中 WXWorkService

参数:

appIndex - 索引

object - AppMarkdownMsg

返回:

AppMsg

uploadTemp

public UploadTemp uploadTemp(int appIndex,
                             UploadTempType tempType,
                             String filePath)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 素材管理 > 上传临时素材

指定者:

uploadTemp 在接口中 WXWorkService

参数:

appIndex - 索引

tempType - UploadTempType

filePath - 临时素材绝对路径

返回:

UploadTemp

uploadImage

public UploadImage uploadImage(int appIndex,
                               String filePath)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 素材管理 > 上传图片

指定者:

uploadImage 在接口中 WXWorkService

参数:

appIndex - 索引

filePath - 图片绝对路径

返回:

UploadImage

downloadTemp

public byte[] downloadTemp(int appIndex,
                           String mediaId)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 素材管理 > 获取临时素材

指定者:

downloadTemp 在接口中 WXWorkService

参数:

appIndex - 索引

mediaId - 媒体文件 id

返回:

字节数组

downloadVoice

public byte[] downloadVoice(int appIndex,
                            String mediaId)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > 素材管理 > 获取高清语音素材

指定者:

downloadVoice 在接口中 WXWorkService

参数:

appIndex - 索引

mediaId - 媒体文件 id

返回:

字节数组

getCheckinRecord

public CheckinRecord getCheckinRecord(int openCheckinDataType,
                                      long startTime,
                                      long endTime,
                                      List<String> userIdList)

从接口复制的说明: WXWorkService

企业内部开发 > 服务端API > OA > 打卡 > 获取打卡记录数据

指定者:

getCheckinRecord 在接口中 WXWorkService

参数:

openCheckinDataType - 打卡类型（1-上下班打卡，2-外出打卡，3-全部打卡）

startTime - 获取打卡记录的开始时间（10 位 Unix 时间戳）

endTime - 获取打卡记录的结束时间（10 位 Unix 时间戳）

userIdList - 工号集合（至多 100 个）

返回:

CheckinRecord

getCorpTicket

public String getCorpTicket(int appIndex)

从接口复制的说明: WXWorkService

企业内部开发 > 客户端API > JS-SDK > 附录 > JS-SDK使用权限签名算法 > 获取企业的jsapi_ticket

指定者:

getCorpTicket 在接口中 WXWorkService

参数:

appIndex - 索引

返回:

企业凭证

getCorpTicketCache

public String getCorpTicketCache(int appIndex)

从接口复制的说明: WXWorkService

企业内部开发 > 客户端API > JS-SDK > 附录 > JS-SDK使用权限签名算法 > 获取企业的jsapi_ticket

指定者:

getCorpTicketCache 在接口中 WXWorkService

参数:

appIndex - 索引

返回:

企业凭证

另请参阅:

WXWorkService.getCorpTicket(int)

getAppTicket

public String getAppTicket(int appIndex)

从接口复制的说明: WXWorkService

企业内部开发 > 客户端API > JS-SDK > 附录 > JS-SDK使用权限签名算法 > 获取应用的jsapi_ticket

指定者:

getAppTicket 在接口中 WXWorkService

参数:

appIndex - 索引

返回:

应用凭证

getAppTicketCache

public String getAppTicketCache(int appIndex)

从接口复制的说明: WXWorkService

企业内部开发 > 客户端API > JS-SDK > 附录 > JS-SDK使用权限签名算法 > 获取应用的jsapi_ticket

指定者:

getAppTicketCache 在接口中 WXWorkService

参数:

appIndex - 索引

返回:

应用凭证

另请参阅:

WXWorkService.getAppTicket(int)

getCorpConfig

public Map<String,Object> getCorpConfig(int appIndex,
                                        String webUrl)

从接口复制的说明: WXWorkService

企业内部开发 > 客户端API > JS-SDK > 开始开发 > 使用说明 > 通过config接口注入权限验证配置

指定者:

getCorpConfig 在接口中 WXWorkService

参数:

appIndex - 索引

webUrl - window.location.href

返回:

Map

getAppConfig

public Map<String,Object> getAppConfig(int appIndex,
                                       String webUrl)

从接口复制的说明: WXWorkService

企业内部开发 > 客户端API > JS-SDK > 基础接口 > wx.agentConfig > 通过agentConfig注入应用的权限

指定者:

getAppConfig 在接口中 WXWorkService

参数:

appIndex - 索引

webUrl - window.location.href

返回:

Map

sendBotTextMsg

public BotMsg sendBotTextMsg(int botIndex,
                             BotTextMsg object)

从接口复制的说明: WXWorkService

企业内部开发 > 客户端API > 群机器人 > 群机器人配置说明 > 文本类型

指定者:

sendBotTextMsg 在接口中 WXWorkService

参数:

botIndex - 索引

object - BotTextMsg

返回:

BotMsg

sendBotMarkdownMsg

public BotMsg sendBotMarkdownMsg(int botIndex,
                                 BotMarkdownMsg object)

从接口复制的说明: WXWorkService

企业内部开发 > 客户端API > 群机器人 > 群机器人配置说明 > markdown类型

指定者:

sendBotMarkdownMsg 在接口中 WXWorkService

参数:

botIndex - 索引

object - BotMarkdownMsg

返回:

BotMsg

get

@Retryable
public String get(int appIndex,
                              URI url)

getAuth

@Retryable
public String getAuth(int appIndex,
                                  URI url)

post

@Retryable
public String post(int appIndex,
                               URI url,
                               Object body)

post

@Retryable
public String post(int appIndex,
                               URI url,
                               String filePath)

post

@Retryable
public byte[] post(int appIndex,
                               URI url)