SDK错误码说明

错误码:

返回值

说明

建议

请求参数错误

检查Init接口corpid、secret参数;检查GetChatData接口limit参数是否未填或大于1000;检查GetMediaData接口sdkfileid是否为空,indexbuf是否正常

网络请求错误

检查是否网络有异常、波动;检查使用代理的情况下代理参数是否设置正确的用户名与密码

数据解析失败

建议重试请求。若仍失败,可以反馈给企业微信进行查询,请提供sdk接口参数与调用时间点等信息

系统调用失败

GetMediaData调用失败,建议重试请求。若仍失败,可以反馈给企业微信进行查询,请提供sdk接口参数与调用时间点等信息

已废弃

目前不会返回此错误码

fileid错误

检查在GetMediaData接口传入的sdkfileid是否正确

解密失败

请检查是否先进行base64decode再进行rsa私钥解密,再进行DecryptMsg调用

已废弃

目前不会返回此错误码

DecryptMsg错误

建议重试请求。若仍失败,可以反馈给企业微信进行查询,请提供sdk接口参数与调用时间点等信息

ip非法

请检查sdk访问外网的ip是否与管理端设置的可信ip匹配,若不匹配会返回此错误码

请求的数据过期

用户欲拉取的数据已过期,仅支持近5天内的数据拉取

ssl证书错误

使用openssl版本sdk,校验ssl证书失败

常见问题解答Q:是否每次调用都需要new sdk,init sdk?A:不需要,首次new sdk后,可以在多次的拉取会话记录/拉取媒体数据,使用同一个sdk进行处理.

Q:corpid/secret 在哪里获取?A: corpid信息在企业微信管理端--我的企业--企业信息查看,secret在企业微信管理端--管理工具--会话内容存档查看

Q:如何拉取指定seq的消息?A:通过seq跟limit来确认拉取消息的范围,每次拉取的是seq+1开始的limit条消息

Q:拉取消息的时间范围与条数范围?A:企业微信只提供5天内的消息拉取,即:从发起拉取的时候往前推5天的消息。如果传入的seq不属于5天内,则从5天内的第一个消息的seq开始拉取。每次最多提供1000条消息的拉取

Q:服务部署在内网,如何拉取?A:通过参数来设置代理进行拉取。支持http代理与sock5代理

Q:管理端填入的ip地址是否可以不填?A:必须填写,企业微信会对ip地址的访问进行限制。对于使用方而言,需要设置其公网ip,企业微信后台收到的请求,会校验调用方的ip与管理端填写的ip是否匹配。

Q:管理端填入的消息加密公钥格式?A:管理端填入RSA2048产生的公钥,后续使用pkcs1进行加密。每次上传公钥都会生成一个公钥版本号,在后续的拉取消息接口中,每条消息都会指明使用的加密公钥版本号。

Q:拉取的消息如何解密?A:企业微信对待存储的消息使用企业最新上传的公钥进行加密,企业自行使用对应版本的私钥进行解密。对json消息体内的encrypt_random_key,base64处理后首先使用对应版本的私钥进行解密得到字符串内容,将字符串内容与消息体内的encrypt_chat_msg,使用sdk的接口DecryptData,得到真正的明文消息。

Q:如何生成秘钥对?A:建议使用openssl 来生成rsa pkcs1 2048格式的公私钥。例如可使用:openssl genrsa -out private.pem 2048 来生成私钥,并使用openssl rsa -in private.pem -pubout -out public.pem从私钥来产生公钥。

Q:so放置在什么地方?A:建议将so放置在系统路径:LD_LIBRARY_PATH指定的路径内,或者将so所在的目录加入到LD_LIBRARY_PATH的路径范围内。

Q:消息体内的from tolist roomid是什么含义?A:如果是单聊:from表示消息发送方、tolist内只有一个消息接收方,roomid为空;如果是群聊:from表示消息发送方,tolist为群内其他成员id,roomid非空;无论消息的发送方还是接收方,如果是本企业成员,则为userid,否则为exteranalopenid

Q:消息何时进行存储?A:如果是金融版企业成员,则所有会话均会存储,包括发送给本企业或者外部企业/微信的会话消息;如果是非本企业的外部用户与本企业成员会话,则只有外部用户同意了当前会话的存储,才会进行存储(不同意存储也可以进行会话)。外部用户的同意,以会话为粒度(单聊或群聊)。

Q:如果群聊内有多个金融版企业,消息如何存储?A:如果外部用户同时与多个金融版企业成员所在的群聊进行会话,那么外部用户会收到不同金融版企业的存储邀请,外部用户同意了哪个金融版企业,会话消息才存储到哪个金融版企业。

Q:如何处理sdk接口调用失败?A:如果出现拉取会话记录、媒体数据失败的情况,建议进行相同参数下一定次数的请求重试。

Q:媒体消息的格式分别是什么?A:图片是jpg格式、语音是amr格式、视频是mp4格式、文件格式类型包括在消息体内,表情分为动图与静态图,在消息体内定义。

Q:提供什么版本的sdk?A:目前提供c版本的so以及java版本的so。Java版本使用jni的方式来进行调用。

Q:为什么发出某些表情得到的是文本消息?A:对于系统内置的表情,是以文本消息的形式发送的,存储的也是文本消息

Q:媒体消息下载也有时间限制吗?A:是的,类似会话记录,也只能拉取5天内的媒体消息内容

Q:支持的消息类型是否覆盖了所有的消息类型?A:目前提供了常用的10+类消息类型的导出,后续如果有新消息类型的产生,也会及时的进行新消息类型的导出。对于目前不识别的消息类型,统一使用:【未知消息类型】的文本消息类型来表示。

Q:是否可以重复拉取消息?A:目前是可以的,支持重入,相同的seq与limit可以多次拉取,但是有频率限制控制。如果过快的拉取,可能会返回失败。

Q:sdk是什么环境的?A:sdk支持linux跟windows环境。

Q:会话记录消息格式是什么?A:通过sdk接口拉取的会话记录为json格式,使用私钥解密后调用sdk接口获取到的消息明文也是json格式。

Q:何时开始存储消息?A:管理端上传秘钥进行开通金融版功能后,企业成员的客户端会被强制要求同意使用金融版。同意使用的企业成员,发出的消息会开始被进行存储。

Q:为什么拉取到的媒体数据不完整?A:请确认下同一个媒体文件,是否是追加写。如果每次覆盖,则得到的文件是最后一个分片的内容。

Q:返回非0错误码如何处理?A:无论对于拉取会话记录,还是拉取媒体消息。如果返回码是10001-10003的错误码,建议原参数重试。

Q:错误码列表如何查看?A:在SDK的头文件内,有错误码列表以及错误码含义解释。

Q:为什么会返回10001错误?A:10001是网络错误,请校验下是否使用代理访问;是否放开了80 443端口。

Q:如何表明已经拉取完会话数据?A:通过GetChatData接口拉取的会话数据,若返回的json结构中,chatdata为空,则表明已拉取完成会话数据。

Q:JAVA版本的sdk报错UnsatisfiedLinkError?A:请检查是否修改了sdk的包名。

Q:SDK返回access_token missing?A:请检查初始化接口中corpid/secret是否填写正确;请检查是否每次都进行了sdk的初始化与销毁,不必每次进行sdk的初始化与销毁。