勤哲Excel服务器WebAPI实用案例：获取企业微信打卡数据

范工，电话（微信同号）：15818855188，QQ：3051828416

一、准备阶段：

二、 获取企业微信打卡应用的access_token。

a) 获取access_token - 接口文档 - 企业微信开发者中心 (qq.com) 打开网页查看技术文档

b) Corpid 来自企业微信，我的企业， 企业ID.

c) Corpsecret 来自每个应用的Secret, 例如打卡应用

d) 进入勤哲系统设计界面，新增一个WebAPI，接口地址参考图一access_token技术文档说明，注意，不要包含？（问号）及后面的部分，这部分会通过请求参数自动拼接到接口URL.

e) 填写请求参数，注意参数名称必须和技术文档里面的一致。默认值可添加也可不添加。

f) 返回参数，可以从企业微信access_token技术文档直接复制粘贴。不需要的字段可以删除。点识别，进入参数集设置，比较简单，唯一要注意的是设置一个成功条件。这个可以根据技术文档描述决定。例如返回errcode为0的时候，代表本次API调用成功， 也可以用errmsg=”ok”为成功标志。确定后即可。

g) Access_token都是有时效性的，默认为7200秒（2小时）。关于access_token获取的时机，有2种方案，自己根据需求灵活决定。方案一，在提取打卡数据时生成（先获取access_token, 随后用它提取打卡数据，全部在一个模板内完成）。方案二，单独做一个模板，专门用来获取(更新)各种应用的access_token. 下面采用方案二进行演示。

h) 勤哲系统新建一个模板，添加一个WebAPI Reader表间公式。然后在工作台新建一张表单，执行表间公式，获取access_token并保存。注意保密access_token，不要在前端任何地方显示完整的access_token.

i) 可以通过下面方法减少access_token在前端暴露的风险。1. 相关单元格使用自定义格式化（;;;**）+ 2. 字段设置为隐藏，不可编辑。

三、 获取打卡数据：

a) 阅读获取企业打卡数据，参看 API文档

b) 在勤哲系统新建一个WebAPI, 参考API文档填写接口地址等。 问号之后的都不要。注意，这个API的调用方法是POST, 前面获取access_token是GET方法。

c) 直接复制API文档里面的请求参数示例，然后点识别。

d) 转到QueryParam界面，点击右上加号，增加一个access_token的参数，文字类型选500或新建一个文字类型，access_token长度为214.

e) 返回参数，直接从API文档复制粘贴，可以删除不要的字段。

f) 点识别后进入参数集界面，设置一个成功条件，确定即可。

g) 在勤哲系统，设计里面新建一个模板，提取企业微信打卡数据。开始时间与结束时间，可以通过EXCEL公式转换为unix时间戳。公式为：(C5-DATE(1970,1,1))*86400，其中C5为引用的普通时间格式。

h) 新建一个普通提数公式，从前面做模板提取access_token.

i) 再新建一个WebApiReader提数公式，从企业微信提取打卡数据。

j) 请求参数设置，其中微信用户_明细.UserId, 其实也是一个从企业微信提取的考勤用户表。也可以手工做一份表。

四、 演示

a) 获取access_token

b) 从企业微信提取打卡数据

五．总结