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

dingtalk.oapi.attendance.group.modify (考勤组更新接口)

提供更新部分考勤组设置功能

公共参数

环境	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。

请求参数

名称	类型	是否必须	示例值	描述
op_user_id	String	必须	123dfd	操作人id
top_group	TopGroupVo	必须		考勤组信息
shift_vo_list TopShiftVo [] 可选班次信息 └ id Number 可选 123 班次id └ id Number 必须 123 考勤组id └ name String 可选百班考勤考勤组名 positions TopPositionVo [] 可选考勤地址 └ address String 可选生物科技产业园区经二路21号地址 └ corp_id String 可选 123dfd corpid └ latitude String 可选 36.687495 纬度 └ longitude String 可选 101.750329 经度 └ title String 可选青藏高原自然博物馆标题 └ accuracy String 可选 0 精度 └ offset Number 可选 300 考勤范围 └ enable_face_check Boolean 可选 true 是否开启人脸检测，已废弃 └ manager_list String [] 可选 ["userId1","userId2"] 考勤组子管理员userid列表 └ enable_camera_check Boolean 可选 true 是否开启拍照打卡，已废弃 └ owner String 可选 123dfdf 考勤组主管理员 └ disable_check_when_rest Boolean 可选 false 休息日打卡需审批(true表示必须审批) └ skip_holidays Boolean 可选 true 休息日自动排休 └ enable_outside_check Boolean 可选 true 是否可以外勤打卡 └ disable_check_without_schedule Boolean 可选 false 未排班时是否禁止员工打卡 └ enable_emp_select_class Boolean 可选 true 未排班时允许员工选择班次打卡 resource_permission_map Resourcepermissionmap 可选子管理员权限范围（w表示可管理，r表示可读） └ camera_check String 可选 w 设置拍照打卡规则 └ over_time_rule String 可选 r 设置加班规则 └ check_position_type String 可选 w 设置打卡方式 └ check_time String 可选 r 设置考勤时间 └ group_type String 可选 w 设置考勤类型 └ group_member String 可选 r 设置参与考勤人员 └ schedule String 可选 w 员工排班 └ out_side_check String 可选 r 设置外勤打卡 └ workday_class_list Number [] 可选 [12,12,12,12,0,0] 周班次列表 └ open_camera_check Boolean 可选 true 是否开启拍照打卡 └ open_face_check Boolean 可选 true 是否开启人脸检测

响应参数

名称	类型	描述
result	TopGroupVo	考勤组结果
└ name String 白班考勤考勤组名 └ id Number 123 考勤组id
errmsg	String	错误信息
errcode	Number	错误码
success	Boolean	是否成功

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/group/modify");
OapiAttendanceGroupModifyRequest req = new OapiAttendanceGroupModifyRequest();
req.setOpUserId("123dfd");
TopGroupVo obj1 = new TopGroupVo();
List<TopShiftVo> list3 = new ArrayList<TopShiftVo>();
TopShiftVo obj4 = new TopShiftVo();
list3.add(obj4);
obj4.setId(123L);
obj1.setShiftVoList(list3);
obj1.setId(123L);
obj1.setName("百班考勤");
List<TopPositionVo> list6 = new ArrayList<TopPositionVo>();
TopPositionVo obj7 = new TopPositionVo();
list6.add(obj7);
obj7.setAddress("生物科技产业园区经二路21号");
obj7.setCorpId("123dfd");
obj7.setLatitude("36.687495");
obj7.setLongitude("101.750329");
obj7.setTitle("青藏高原自然博物馆");
obj7.setAccuracy("0");
obj1.setPositions(list6);
obj1.setOffset(300L);
obj1.setEnableFaceCheck(true);
obj1.setManagerList(""userId1","userId2"");
obj1.setEnableCameraCheck(true);
obj1.setOwner("123dfdf");
obj1.setDisableCheckWhenRest(false);
obj1.setSkipHolidays(true);
obj1.setEnableOutsideCheck(true);
obj1.setDisableCheckWithoutSchedule(false);
obj1.setEnableEmpSelectClass(true);
Resourcepermissionmap obj8 = new Resourcepermissionmap();
obj8.setCameraCheck("w");
obj8.setOverTimeRule("r");
obj8.setCheckPositionType("w");
obj8.setCheckTime("r");
obj8.setGroupType("w");
obj8.setGroupMember("r");
obj8.setSchedule("w");
obj8.setOutSideCheck("r");
obj1.setResourcePermissionMap(obj8);
obj1.setWorkdayClassList(new Long[] { 12,12,12,12,0,0 };
);
obj1.setOpenCameraCheck(true);
obj1.setOpenFaceCheck(true);
req.setTopGroup(obj1);
OapiAttendanceGroupModifyResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/group/modify");
OapiAttendanceGroupModifyRequest req = new OapiAttendanceGroupModifyRequest();
req.OpUserId = "123dfd";
OapiAttendanceGroupModifyRequest.TopGroupVoDomain obj1 = new OapiAttendanceGroupModifyRequest.TopGroupVoDomain();
List<OapiAttendanceGroupModifyRequest.TopShiftVoDomain> list3 = new List<OapiAttendanceGroupModifyRequest.TopShiftVoDomain>();
OapiAttendanceGroupModifyRequest.TopShiftVoDomain obj4 = new OapiAttendanceGroupModifyRequest.TopShiftVoDomain();
list3.Add(obj4);
obj4.Id = 123L;
obj1.ShiftVoList= list3;
obj1.Id = 123L;
obj1.Name = "百班考勤";
List<OapiAttendanceGroupModifyRequest.TopPositionVoDomain> list6 = new List<OapiAttendanceGroupModifyRequest.TopPositionVoDomain>();
OapiAttendanceGroupModifyRequest.TopPositionVoDomain obj7 = new OapiAttendanceGroupModifyRequest.TopPositionVoDomain();
list6.Add(obj7);
obj7.Address = "生物科技产业园区经二路21号";
obj7.CorpId = "123dfd";
obj7.Latitude = "36.687495";
obj7.Longitude = "101.750329";
obj7.Title = "青藏高原自然博物馆";
obj7.Accuracy = "0";
obj1.Positions= list6;
obj1.Offset = 300L;
obj1.EnableFaceCheck = true;
obj1.ManagerList = ""userId1","userId2"";
obj1.EnableCameraCheck = true;
obj1.Owner = "123dfdf";
obj1.DisableCheckWhenRest = false;
obj1.SkipHolidays = true;
obj1.EnableOutsideCheck = true;
obj1.DisableCheckWithoutSchedule = false;
obj1.EnableEmpSelectClass = true;
OapiAttendanceGroupModifyRequest.ResourcepermissionmapDomain obj8 = new OapiAttendanceGroupModifyRequest.ResourcepermissionmapDomain();
obj8.CameraCheck = "w";
obj8.OverTimeRule = "r";
obj8.CheckPositionType = "w";
obj8.CheckTime = "r";
obj8.GroupType = "w";
obj8.GroupMember = "r";
obj8.Schedule = "w";
obj8.OutSideCheck = "r";
obj1.ResourcePermissionMap= obj8;
obj1.WorkdayClassList = new long[] { 12,12,12,12,0,0 };
;
obj1.OpenCameraCheck = true;
obj1.OpenFaceCheck = true;
req.TopGroup_ = obj1;
OapiAttendanceGroupModifyResponse 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 OapiAttendanceGroupModifyRequest;
$req->setOpUserId("123dfd");
$top_group = new TopGroupVo;
$shift_vo_list = new TopShiftVo;
$shift_vo_list->id="123";
$top_group->shift_vo_list = array($shift_vo_list);
$top_group->id="123";
$top_group->name="百班考勤";
$positions = new TopPositionVo;
$positions->address="生物科技产业园区经二路21号";
$positions->corp_id="123dfd";
$positions->latitude="36.687495";
$positions->longitude="101.750329";
$positions->title="青藏高原自然博物馆";
$positions->accuracy="0";
$top_group->positions = array($positions);
$top_group->offset="300";
$top_group->enable_face_check="true";
$top_group->manager_list="[\"userId1\",\"userId2\"]";
$top_group->enable_camera_check="true";
$top_group->owner="123dfdf";
$top_group->disable_check_when_rest="false";
$top_group->skip_holidays="true";
$top_group->enable_outside_check="true";
$top_group->disable_check_without_schedule="false";
$top_group->enable_emp_select_class="true";
$resource_permission_map = new Resourcepermissionmap;
$resource_permission_map->camera_check="w";
$resource_permission_map->over_time_rule="r";
$resource_permission_map->check_position_type="w";
$resource_permission_map->check_time="r";
$resource_permission_map->group_type="w";
$resource_permission_map->group_member="r";
$resource_permission_map->schedule="w";
$resource_permission_map->out_side_check="r";
$top_group->resource_permission_map = $resource_permission_map;
$top_group->workday_class_list="[12,12,12,12,0,0]";
$top_group->open_camera_check="true";
$top_group->open_face_check="true";
$req->setTopGroup($top_group);
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/attendance/group/modify");

curl -X POST "https://oapi.dingtalk.com/topapi/attendance/group/modify" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=f4ac052a-2514-46da-9912-ca73197d5d71' \
-d 'op_user_id=123dfd' \
-d 'top_group=null'

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

req=dingtalk.api.OapiAttendanceGroupModifyRequest("https://oapi.dingtalk.com/topapi/attendance/group/modify")

req.op_user_id="123dfd"
req.top_group=""
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.group.modify");
add_param(pRequest,"op_user_id","123dfd");
add_param(pRequest,"top_group","数据结构JSON示例");
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.group.modify', {
	'op_user_id':'123dfd',
	'top_group':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "result":{
        "name":"白班考勤",
        "id":123
    },
    "errmsg":"",
    "errcode":,
    "success":
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案
isp.top-remote-method-connection-error

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.attendance.group.modify (考勤组更新接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ