文档中心 > API类目 > 钉钉API

dingtalk.oapi.attendance.getupdatedata (获取考勤更新数据)

增加这个api的目的是为了给外部企业提供考勤数据变更，提升外部企业的考勤统计数据的准确度。外部企业只能通过入参获取数据，属于只读接口。接口的入参是查询用户corpId，userid以及查询日期，这些参数是我们开放平台推送给用户的变更。返回的结果是三个list结果：分别是打卡流水记录打卡结果以及审批列表都是被查询用户在查询日期内的数据。

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
userid	String	必须	userId123456		用户id
work_date	Date	必须	2018-05-02 00:00:00		工作日

响应参数

名称	类型	示例值	描述
errmsg	String	系统繁忙	errorMsg
result	AtCheckInfoForOpenVo	result	result
└ work_date Date 1524672000000 查询日期 attendance_result_list AtAttendanceResultForOpenVo [] 打卡结果list └ record_id Number 5407430003 打卡流水id └ source_type String USER 打卡来源 └ plan_check_time Date 1524153600000 标准打卡时间 └ class_id Number 189985024 班次id └ location_method String Map 定位方法 └ location_result String Outside 定位结果 └ outside_remark String 拜访客户外勤备注 └ plan_id Number 17876785001 排班id └ user_address String 浙江省杭州市西湖区蒋村街道文二西路884号龙章大厦用户打卡地址 └ group_id Number 108560029 考勤组id └ user_check_time Date 1524153600000 用户打卡时间 └ procInst_id String 05b286d9-2e89-4f6f-9905-b665d8afbe05 审批单id └ check_type String OnDuty 打卡类型上班还是下班 └ time_result String Absenteeism 打卡的时间结果 └ userid String 0706051637754855 用户id approve_list AtApproveForOpenVo [] 审批单列表 └ duration_unit String DAY 审批单的单位 └ duration String 1 时长 └ sub_type String 国际出差子类型 └ tag_name String 出差审批单的tag └ procInst_id String 05b286d9-2e89-4f6f-9905-b665d8afbe05 审批单id └ begin_time Date 1524153600000 审批单开始时间 └ biz_type Number 2 业务类型 └ end_time Date 1524153600000 审批单结束时间 └ gmt_finished Date 1524153600000 审批单审批完成时间 check_record_list AtAttendanceRecordForOpenVo [] 打卡流水list └ record_id Number 5407430003 流水id └ source_type String USER 打卡来源 └ user_accuracy String 65 用户定位精度 └ valid_matched Boolean false 是否匹配 └ user_check_time Date 1524153600000 用户打卡时间 └ user_longitude String 120.060609 打卡维度 └ user_ssid String alibaba-inc wifi名称 └ base_accuracy String 65 基本定位精度 └ user_mac_addr String 14:1F:BA:7A:B2:A8 mac地址 └ user_latitude String 30.280309 打卡纬度 └ base_address String 打卡基础地质 └ invalid_record_msg String 你在使用虚拟定位软件打卡流水无效的原因 └ invalid_record_type String Security 流水无效的类型 └ corpId String ding74d4d27d11a6204535c2f4657eb6378f 公司id class_setting_info AtClassSettingInfoForOpenVo 当前排班对应的休息时间段 rest_time_vo_list AtRestTimeVo [] restTimeVOList └ rest_end_time Number 39060000 休息结束时间 └ rest_begin_time Number 36120000 休息开始时间
errcode	Number	-1	dingOpenErrcode
success	Boolean	true	success

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getupdatedata");
OapiAttendanceGetupdatedataRequest req = new OapiAttendanceGetupdatedataRequest();
req.setUserid("userId123456");
req.setWorkDate(StringUtils.parseDateTime("2018-05-02 00:00:00"));
OapiAttendanceGetupdatedataResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getupdatedata");
OapiAttendanceGetupdatedataRequest req = new OapiAttendanceGetupdatedataRequest();
req.Userid = "userId123456";
req.WorkDate = DateTime.Parse("2018-05-02 00:00:00");
OapiAttendanceGetupdatedataResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiAttendanceGetupdatedataRequest;
$req->setUserid("userId123456");
$req->setWorkDate("2018-05-02 00:00:00");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/attendance/getupdatedata");

curl -X POST "https://oapi.dingtalk.com/topapi/attendance/getupdatedata" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=33405559-43c2-45fa-901c-af0ddd85e4a8' \
-d 'userid=userId123456' \
-d 'work_date=2018-05-02+00%3A00%3A00'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiAttendanceGetupdatedataRequest("https://oapi.dingtalk.com/topapi/attendance/getupdatedata")

req.userid="userId123456"
req.work_date="2018-05-02 00:00:00"
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.attendance.getupdatedata");
add_param(pRequest,"userid","userId123456");
add_param(pRequest,"work_date","2018-05-02 00:00:00");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.attendance.getupdatedata', {
	'userid':'userId123456',
	'work_date':'2018-05-02 00:00:00'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "errmsg":"系统繁忙",
    "result":{
        "work_date":"1524672000000",
        "attendance_result_list":[
            {
                    "record_id":5407430003,
                    "source_type":"USER",
                    "plan_check_time":"1524153600000",
                    "class_id":189985024,
                    "location_method":"Map",
                    "location_result":"Outside",
                    "outside_remark":"拜访客户",
                    "plan_id":17876785001,
                    "user_address":"浙江省杭州市西湖区蒋村街道文二西路884号龙章大厦",
                    "group_id":108560029,
                    "user_check_time":"1524153600000",
                    "procInst_id":"05b286d9-2e89-4f6f-9905-b665d8afbe05",
                    "check_type":"OnDuty",
                    "time_result":"Absenteeism"
            }
        ],
        "userid":"0706051637754855",
        "approve_list":[
            {
                    "duration_unit":"DAY",
                    "duration":"1",
                    "sub_type":"国际出差",
                    "tag_name":"出差",
                    "procInst_id":"05b286d9-2e89-4f6f-9905-b665d8afbe05",
                    "begin_time":"1524153600000",
                    "biz_type":2,
                    "end_time":"1524153600000",
                    "gmt_finished":"1524153600000"
            }
        ],
        "check_record_list":[
            {
                    "record_id":5407430003,
                    "source_type":"USER",
                    "user_accuracy":"65",
                    "valid_matched":false,
                    "user_check_time":"1524153600000",
                    "user_longitude":"120.060609",
                    "user_ssid":"alibaba-inc",
                    "base_accuracy":"65",
                    "user_mac_addr":"14:1F:BA:7A:B2:A8",
                    "user_latitude":"30.280309",
                    "base_address":"",
                    "invalid_record_msg":"你在使用虚拟定位软件打卡",
                    "invalid_record_type":"Security"
            }
        ],
        "corpId":"ding74d4d27d11a6204535c2f4657eb6378f",
        "class_setting_info":{
            "rest_time_vo_list":[
                {
                        "rest_end_time":39060000,
                        "rest_begin_time":36120000
                }
            ]
        }
    },
    "errcode":-1,
    "success":true
}

异常示例

JSON示例

{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

用户反馈

亲，您还没填写反馈内容。

联系方式

亲，电话号码格式不正确。

验证码刷新
亲，验证码错啦！

提交反馈

用户反馈

感谢您的反馈！

用户反馈

网络异常，请重新提交！
重新提交

钉钉API

dingtalk.oapi.attendance.getupdatedata (获取考勤更新数据)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈