me.chanjar.weixin.cp.api.impl

类 WxCpMsgAuditServiceImpl

java.lang.Object

me.chanjar.weixin.cp.api.impl.WxCpMsgAuditServiceImpl

所有已实现的接口:

WxCpMsgAuditService

public class WxCpMsgAuditServiceImpl
extends Object
implements WxCpMsgAuditService

会话内容存档接口实现类.

作者:

Wang_Wong created on 2022-01-17

构造器概要

构造器

构造器和说明
WxCpMsgAuditServiceImpl()

方法概要

限定符和类型	方法和说明
WxCpAgreeInfo	checkSingleAgree(@NonNull WxCpCheckAgreeRequest checkAgreeRequest) 获取会话同意情况 企业可通过下述接口，获取会话中外部成员的同意情况 单聊请求地址：https://qyapi.weixin.qq.com/cgi-bin/msgaudit/check_single_agree?
String	decryptChatData(long sdk, WxCpChatDatas.WxCpChatData chatData, Integer pkcs1) Decrypt chat data string.
WxCpChatDatas	getChatDatas(long seq, @NonNull long limit, String proxy, String passwd, @NonNull long timeout) 拉取聊天记录函数
String	getChatPlainText(@NonNull long sdk, WxCpChatDatas.WxCpChatData chatData, @NonNull Integer pkcs1) 获取解密的聊天数据明文
WxCpChatModel	getDecryptData(@NonNull long sdk, WxCpChatDatas.WxCpChatData chatData, @NonNull Integer pkcs1) 获取解密的聊天数据Model
WxCpGroupChat	getGroupChat(@NonNull String roomid) 获取会话内容存档内部群信息 企业可通过此接口，获取会话内容存档本企业的内部群信息，包括群名称、群主id、公告、群创建时间以及所有群成员的id与加入时间。
void	getMediaFile(@NonNull long sdk, @NonNull String sdkfileid, String proxy, String passwd, @NonNull long timeout, @NonNull java.util.function.Consumer<byte[]> action) 获取媒体文件 传入一个lambda，each所有的数据分片byte[]，更加灵活 针对图片、文件等媒体数据，提供sdk接口拉取数据内容。
void	getMediaFile(@NonNull long sdk, @NonNull String sdkfileid, String proxy, String passwd, @NonNull long timeout, @NonNull String targetFilePath) 获取媒体文件 针对图片、文件等媒体数据，提供sdk接口拉取数据内容。
List<String>	getPermitUserList(Integer type) 获取会话内容存档开启成员列表 企业可通过此接口，获取企业开启会话内容存档的成员列表 请求方式：POST（HTTPS） 请求地址：https://qyapi.weixin.qq.com/cgi-bin/msgaudit/get_permit_user_list?

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

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

构造器详细资料

WxCpMsgAuditServiceImpl

public WxCpMsgAuditServiceImpl()

方法详细资料

getChatDatas

public WxCpChatDatas getChatDatas(long seq,
                                  @NonNull
                                  @NonNull long limit,
                                  String proxy,
                                  String passwd,
                                  @NonNull
                                  @NonNull long timeout)
                           throws Exception

从接口复制的说明: WxCpMsgAuditService

拉取聊天记录函数

指定者:

getChatDatas 在接口中 WxCpMsgAuditService

参数:

seq - 从指定的seq开始拉取消息，注意的是返回的消息从seq+1开始返回，seq为之前接口返回的最大seq值。首次使用请使用seq:0

limit - 一次拉取的消息条数，最大值1000条，超过1000条会返回错误

proxy - 使用代理的请求，需要传入代理的链接。如：socks5://10.0.0.1:8081 或者 http://10.0.0.1:8081，如果没有传null

passwd - 代理账号密码，需要传入代理的账号密码。如 user_name:passwd_123，如果没有传null

timeout - 超时时间，根据实际需要填写

返回:

返回是否调用成功 chat datas

抛出:

Exception - the exception

getDecryptData

public WxCpChatModel getDecryptData(@NonNull
                                    @NonNull long sdk,
                                    @NonNull
                                    WxCpChatDatas.WxCpChatData chatData,
                                    @NonNull
                                    @NonNull Integer pkcs1)
                             throws Exception

从接口复制的说明: WxCpMsgAuditService

获取解密的聊天数据Model

指定者:

getDecryptData 在接口中 WxCpMsgAuditService

参数:

sdk - getChatDatas()获取到的sdk

chatData - getChatDatas()获取到的聊天数据

pkcs1 - 使用什么方式进行解密，1代表使用PKCS1进行解密，2代表PKCS8进行解密 ...

返回:

解密后的聊天数据 decrypt data

抛出:

Exception - the exception

decryptChatData

public String decryptChatData(long sdk,
                              WxCpChatDatas.WxCpChatData chatData,
                              Integer pkcs1)
                       throws Exception

Decrypt chat data string.

参数:

sdk - the sdk

chatData - the chat data

pkcs1 - the pkcs 1

返回:

the string

抛出:

Exception - the exception

getChatPlainText

public String getChatPlainText(@NonNull
                               @NonNull long sdk,
                               WxCpChatDatas.WxCpChatData chatData,
                               @NonNull
                               @NonNull Integer pkcs1)
                        throws Exception

从接口复制的说明: WxCpMsgAuditService

获取解密的聊天数据明文

指定者:

getChatPlainText 在接口中 WxCpMsgAuditService

参数:

sdk - getChatDatas()获取到的sdk

chatData - getChatDatas()获取到的聊天数据

pkcs1 - 使用什么方式进行解密，1代表使用PKCS1进行解密，2代表PKCS8进行解密 ...

返回:

解密后的明文 chat plain text

抛出:

Exception - the exception

getMediaFile

public void getMediaFile(@NonNull
                         @NonNull long sdk,
                         @NonNull
                         @NonNull String sdkfileid,
                         String proxy,
                         String passwd,
                         @NonNull
                         @NonNull long timeout,
                         @NonNull
                         @NonNull String targetFilePath)
                  throws WxErrorException

从接口复制的说明: WxCpMsgAuditService

获取媒体文件 针对图片、文件等媒体数据，提供sdk接口拉取数据内容。

注意： 根据上面返回的文件类型，拼接好存放文件的绝对路径即可。此时绝对路径写入文件流，来达到获取媒体文件的目的。 详情可以看官方文档，亦可阅读此接口源码。

指定者:

getMediaFile 在接口中 WxCpMsgAuditService

参数:

sdk - getChatDatas()获取到的sdk，注意，每次获取的sdk会不一样

sdkfileid - 消息体内容中的sdkfileid信息

proxy - 使用代理的请求，需要传入代理的链接。如：socks5://10.0.0.1:8081 或者 http://10.0.0.1:8081，如果没有传null

passwd - 代理账号密码，需要传入代理的账号密码。如 user_name:passwd_123，如果没有传null

timeout - 超时时间，分片数据需累加到文件存储。单次最大返回512K字节，如果文件比较大，自行设置长一点，比如timeout=10000

targetFilePath - 目标文件绝对路径+实际文件名，比如：/usr/local/file/20220114/474f866b39d10718810d55262af82662.gif

抛出:

WxErrorException - the wx error exception

getMediaFile

public void getMediaFile(@NonNull
                         @NonNull long sdk,
                         @NonNull
                         @NonNull String sdkfileid,
                         String proxy,
                         String passwd,
                         @NonNull
                         @NonNull long timeout,
                         @NonNull
                         @NonNull java.util.function.Consumer<byte[]> action)
                  throws WxErrorException

从接口复制的说明: WxCpMsgAuditService

获取媒体文件 传入一个lambda，each所有的数据分片byte[]，更加灵活 针对图片、文件等媒体数据，提供sdk接口拉取数据内容。 详情可以看官方文档，亦可阅读此接口源码。

指定者:

getMediaFile 在接口中 WxCpMsgAuditService

参数:

sdk - getChatDatas()获取到的sdk，注意，每次获取的sdk会不一样

sdkfileid - 消息体内容中的sdkfileid信息

proxy - 使用代理的请求，需要传入代理的链接。如：socks5://10.0.0.1:8081 或者 http://10.0.0.1:8081，如果没有传null

passwd - 代理账号密码，需要传入代理的账号密码。如 user_name:passwd_123，如果没有传null

timeout - 超时时间，分片数据需累加到文件存储。单次最大返回512K字节，如果文件比较大，自行设置长一点，比如timeout=10000

action - 传入一个lambda，each所有的数据分片

抛出:

WxErrorException - the wx error exception

getPermitUserList

public List<String> getPermitUserList(Integer type)
                               throws WxErrorException

从接口复制的说明: WxCpMsgAuditService

获取会话内容存档开启成员列表 企业可通过此接口，获取企业开启会话内容存档的成员列表

请求方式：POST（HTTPS） 请求地址：https://qyapi.weixin.qq.com/cgi-bin/msgaudit/get_permit_user_list?access_token=ACCESS_TOKEN

指定者:

getPermitUserList 在接口中 WxCpMsgAuditService

参数:

type - 拉取对应版本的开启成员列表。1表示办公版；2表示服务版；3表示企业版。非必填，不填写的时候返回全量成员列表。

返回:

permit user list

抛出:

WxErrorException - the wx error exception

getGroupChat

public WxCpGroupChat getGroupChat(@NonNull
                                  @NonNull String roomid)
                           throws WxErrorException

从接口复制的说明: WxCpMsgAuditService

获取会话内容存档内部群信息 企业可通过此接口，获取会话内容存档本企业的内部群信息，包括群名称、群主id、公告、群创建时间以及所有群成员的id与加入时间。

请求方式：POST（HTTPS） 请求地址：https://qyapi.weixin.qq.com/cgi-bin/msgaudit/groupchat/get?access_token=ACCESS_TOKEN

指定者:

getGroupChat 在接口中 WxCpMsgAuditService

参数:

roomid - 待查询的群id

返回:

group chat

抛出:

WxErrorException - the wx error exception

checkSingleAgree

public WxCpAgreeInfo checkSingleAgree(@NonNull
                                      @NonNull WxCpCheckAgreeRequest checkAgreeRequest)
                               throws WxErrorException

从接口复制的说明: WxCpMsgAuditService

获取会话同意情况 企业可通过下述接口，获取会话中外部成员的同意情况

单聊请求地址：https://qyapi.weixin.qq.com/cgi-bin/msgaudit/check_single_agree?access_token=ACCESS_TOKEN

请求方式：POST（HTTPS）

指定者:

checkSingleAgree 在接口中 WxCpMsgAuditService

参数:

checkAgreeRequest - 待查询的会话信息

返回:

wx cp agree info

抛出:

WxErrorException - the wx error exception