dingtalk.oapi.attendance.getcolumnval (获取智能考勤报表的列值)

该接口用于获取钉钉智能考勤报表的列值数据,其中包含了一定时间段内报表某一列的所有数据,以及相关的列信息,可以供指定的ISV进行使用。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
userid String 可选 zhangsan 用户的userId
column_id_list Number [] 可选 1,2,3
  • 最大列表长度:20
  • 列id,多值用英文逗号分隔
    from_date Date 可选 2018-07-11 12:12:12 开始时间
    to_date Date 可选 2018-07-11 12:12:12 结束时间

    响应参数

    名称 类型 示例值 描述
    errmsg String errorMsg
    errcode Number dingOpenErrcode
    result ColumnValListForTopVo result
    • column_vals
    • ColumnValForTopVo []
    • 列信息与列值数据
    • column_vals
    • ColumnDayAndVal []
    • 列值数据
    • └ date
    • Date
    • 时间
    • └ value
    • String
    • 列值
    • column_vo
    • ColumnForTopVo
    • 列信息
    • └ id
    • Number
    • 列id
    • └ fixed_value
    • String
    • 一些不需要计算得固定值,如出勤天数等

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getcolumnval");
    OapiAttendanceGetcolumnvalRequest req = new OapiAttendanceGetcolumnvalRequest();
    req.setUserid("zhangsan");
    req.setColumnIdList("1,2,3");
    req.setFromDate(StringUtils.parseDateTime("2018-07-11 12:12:12"));
    req.setToDate(StringUtils.parseDateTime("2018-07-11 12:12:12"));
    OapiAttendanceGetcolumnvalResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    {
        "errmsg":"",
        "errcode":,
        "result":{
            "column_vals":[
                {
                        "column_vals":[
                            {
                                    "date":"",
                                    "value":""
                            }
                        ],
                        "column_vo":{
                            "id":
                        },
                        "fixed_value":""
                }
            ]
        }
    }

    异常示例

    • JSON示例
    {
    	"errcode":88,
    	"errmsg":"ding talk error"
    }

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部