应用平台 APPSTAGE-企业微信:获取打卡记录数据

时间:2024-06-11 14:30:40

获取打卡记录数据

获取打卡的记录数据。

  • 输入参数
    输入参数说明如表43所示。
    表43 获取打卡记录数据输入参数说明

    参数

    必填

    说明

    获取打卡记录的结束时间

    获取打卡记录的结束时间,unix时间戳。

    打卡类型

    打卡类型。

    • 上下班打卡
    • 外出打卡
    • 全部打卡

    获取打卡记录的开始时间

    获取打卡记录的开始时间,unix时间戳。

    调用接口凭证

    调用接口凭证。必须使用打卡应用的secret获取access_token。

    需要获取打卡记录的用户列表

    需要获取打卡记录的用户列表。

  • 输出参数

    用户可以在之后的执行动作中调用该输出参数,输出参数说明请参见表44

    表44 获取打卡记录数据输出参数说明

    参数

    说明

    errcode

    返回码。

    errmsg

    返回码的描述内容。

    checkindata

    检查数据。

    -userid

    用户ID。

    -groupname

    打卡规则名称。

    -checkin_type

    打卡类型。目前包含以下几种:

    • 上班打卡
    • 下班打卡
    • 外出打卡

    -exception_type

    异常类型。如果有多个异常,以分号间隔。

    异常情况包含以下情形:

    • 时间异常
    • 地点异常
    • 未打卡
    • wifi异常
    • 非常用设备

    -checkin_time

    打卡时间,unix时间戳。

    -location_title

    打卡地点title。

    -location_detail

    打卡地点详情。

    -wifiname

    打卡wifi名称。

    -notes

    打卡备注。

    -wifimac

    打卡的MAC地址/bssid。

    -mediaids

    打卡的附件media_id,可使用media/get获取附件。

    -sch_checkin_time

    标准打卡时间,指此次打卡时间对应的标准上班时间或标准下班时间。

    -groupid

    规则ID,表示打卡记录所属规则的ID。

    -schedule_id

    班次ID,表示打卡记录所属规则中,所属班次的ID。

    -timeline_id

    时段ID,表示打卡记录所属规则中,某一班次中的某一时段的ID,如上下班时间为9:00-12:00、13:00-18:00的班次中,9:00-12:00为其中一组时段。

    -lat

    位置打卡地点维度,是实际维度的1000000倍,与腾讯地图一致采用GCJ-02坐标系统标准。

    -lng

    位置打卡地点经度,是实际经度的1000000倍,与腾讯地图一致采用GCJ-02坐标系统标准。

    -deviceid

    打卡设备ID。

support.huaweicloud.com/usermanual-wiseagent/appstage_04_1014.html