整体流程

业务方通过企业微信提供的sdk,可以进行会话记录数据的获取、媒体数据的获取。

linux环境 SDK:

下载 SDK v1.2 [更新时间:2020-11-16 更新特性:更新sdk示例项目]

下载 SDK v1.1 [更新时间:2020-04-01 更新特性:支持并发调用]

下载 SDK v1.0

windows环境 SDK:

下载 SDK v1.1[更新时间:2020-12-23 更新特性:支持并发调用、更新sdk示例项目]

下载 SDK v1.0 以下是交互时序图,本文重点介绍sdk的内容。

sdk包括如下接口:

  1. 初始化接口;
  2. 提供分页批量拉取会话记录接口的sdk接口;
  3. 对会话数据进行解密接口;
  4. 对图片、文件等媒体数据,拉取媒体数据内容的sdk接口;
  5. 工具函数,进行数据的析构等处理.

初始化接口

获取会话记录数据

通过本sdk接口来获取公司一段时间内的会话记录。一次拉取调用上限1000条会话记录,可以通过分页拉取的方式来依次拉取。调用频率不可超过600次/分钟。

请求参数说明:

参数

是否必须

说明

sdk

初始化的sdk对象

seq

本次请求获取消息记录开始的seq值。首次访问填写0,非首次使用上次企业微信返回的最大seq。允许从任意seq重入拉取。Uint64类型,范围0-pow(2,64)-1

limit

一次调用限制的limit值,不能超过1000.uint32类型

proxy

使用代理的请求,需要传入代理的链接。如:socks5://10.0.0.1:8081 或者 http://10.0.0.1:8081.如不使用代理可以设置为空. 支持sock5跟http代理

paswd

代理账号密码,需要传入代理的账号密码。如 user_name:passwd_123

timeout

超时时长,单位 秒

chatDatas

返回本次拉取消息的数据.密文消息