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

dingtalk.oapi.attendance.group.add (考勤组写入)

考勤组写入接口

公共参数

环境	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	必须		考勤组信息
└ owner String 可选 123dfdf 考勤组owner └ enable_emp_select_class Boolean 可选 true 未排班时允许员工选择班次打卡 └ corp_id String 可选 dingdfe corpId └ skip_holidays Boolean 可选 true 是否跳过节假日 └ special_days String 可选 {"onDuty":{1400000:123,1400001:123},"offDuty":[1400000,1400001]} 特殊日期配置 └ enable_outside_camera_check Boolean 可选 true 是否开启外勤打卡必须拍照 positions TopPositionVo [] 可选考勤地址 └ address String 可选生物科技产业园区经二路21号地址 └ corp_id String 可选 123dfd corpId └ latitude String 可选 36.687495 纬度 └ accuracy String 可选 0 精度 └ title String 可选青藏高原自然博物馆标题 └ longitude String 可选 101.750329 经度 └ modify_member Boolean 可选 true 是否有修改考勤组成员相关信息 └ type String 必须 TURN 考勤组类型 └ enable_face_check Boolean 可选 true 是否开启人脸检测 └ check_need_healthy_code Boolean 可选 true 打卡是否需要健康码 └ enable_camera_check Boolean 可选 true 是否开启拍照打卡 shift_vo_list TopShiftVo [] 可选班次信息 └ id Number 可选 123 班次id └ enable_outside_check Boolean 可选 true 是否可以外勤打卡 members TopMemberVo [] 必须考勤组成员 └ role String 必须 Attendance 角色 └ corp_id String 可选 123dfd corpId └ type String 必须 StaffMember 类型 └ user_id String 必须 1212jfkd 用户id └ name String 必须白班考勤考勤组名 └ id Number 可选 123 考勤组id └ enable_next_day Boolean 可选 false 是否第二天生效 └ manager_list String [] 可选 ["userId1","userId2"] 考勤组子管理员userid列表 └ workday_class_list Number [] 可选 [12,12,12,12,12,0,0] 周班次列表（固定班制必填，0表示休息） └ default_class_id Number 可选 1234 默认班次id（固定班制必填） └ offset Number 可选 500 考勤范围 resource_permission_map TopGroupManageRolePermissionVo 可选子管理员权限范围（w表示可管理，r表示可读） └ schedule String 可选 w 员工排班 └ group_member String 可选 w 设置参与考勤人员 └ group_type String 可选 r 设置考勤类型 └ check_time String 可选 w 设置考勤时间 └ check_position_type String 可选 r 设置打卡方式 └ over_time_rule String 可选 r 设置加班规则 └ camera_check String 可选 w 设置拍照打卡规则 └ out_side_check String 可选 w 设置外勤打卡 wifis TopWifiVo [] 可选考勤wifi打卡 └ mac_addr String 可选 C0:E0:D0:E0:C0:0F mac地址 └ ssid String 可选 OFFICE-WiFi wifi的ssid └ corp_id String 可选 123dfd 企业corpid └ disable_check_without_schedule Boolean 可选 false 未排班时是否禁止员工打卡 └ freecheck_work_days Number [] 可选 [1,2,3,4,5,6,0] 自由工时考勤组工作日（1表示周一，0表示周日） └ freecheck_day_start_min_offset Number 可选 240 自由工时考勤组考勤开始时间与当天0点偏移分钟数（如：240表示4:00） └ disable_check_when_rest Boolean 可选 false 休息日打卡是否需审批。true：需要 false：不需要 └ enable_position_ble Boolean 可选 false 是否启用蓝牙定位 ble_device_list TopAtBleDeviceVO [] 可选蓝牙打卡信息 └ device_id Number 可选 1311089987 设备id

响应参数

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

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/group/add");
OapiAttendanceGroupAddRequest req = new OapiAttendanceGroupAddRequest();
req.setOpUserId("123dfd");
TopGroupVo obj1 = new TopGroupVo();
obj1.setOwner("123dfdf");
obj1.setEnableEmpSelectClass(true);
obj1.setCorpId("dingdfe");
obj1.setSkipHolidays(true);
obj1.setSpecialDays("{\"onDuty\":{1400000:123,1400001:123},\"offDuty\":[1400000,1400001]}");
obj1.setEnableOutsideCameraCheck(true);
List<TopPositionVo> list3 = new ArrayList<TopPositionVo>();
TopPositionVo obj4 = new TopPositionVo();
list3.add(obj4);
obj4.setAddress("生物科技产业园区经二路21号");
obj4.setCorpId("123dfd");
obj4.setLatitude("36.687495");
obj4.setAccuracy("0");
obj4.setTitle("青藏高原自然博物馆");
obj4.setLongitude("101.750329");
obj1.setPositions(list3);
obj1.setModifyMember(true);
obj1.setType("TURN");
obj1.setEnableFaceCheck(true);
obj1.setCheckNeedHealthyCode(true);
obj1.setEnableCameraCheck(true);
List<TopShiftVo> list6 = new ArrayList<TopShiftVo>();
TopShiftVo obj7 = new TopShiftVo();
list6.add(obj7);
obj7.setId(123L);
obj1.setShiftVoList(list6);
obj1.setEnableOutsideCheck(true);
List<TopMemberVo> list9 = new ArrayList<TopMemberVo>();
TopMemberVo obj10 = new TopMemberVo();
list9.add(obj10);
obj10.setRole("Attendance");
obj10.setCorpId("123dfd");
obj10.setType("StaffMember");
obj10.setUserId("1212jfkd");
obj1.setMembers(list9);
obj1.setName("白班考勤");
obj1.setId(123L);
obj1.setEnableNextDay(false);
obj1.setManagerList(""userId1","userId2"");
obj1.setWorkdayClassList(new Long[] { 12,12,12,12,12,0,0 };
);
obj1.setDefaultClassId(1234L);
obj1.setOffset(500L);
TopGroupManageRolePermissionVo obj11 = new TopGroupManageRolePermissionVo();
obj11.setSchedule("w");
obj11.setGroupMember("w");
obj11.setGroupType("r");
obj11.setCheckTime("w");
obj11.setCheckPositionType("r");
obj11.setOverTimeRule("r");
obj11.setCameraCheck("w");
obj11.setOutSideCheck("w");
obj1.setResourcePermissionMap(obj11);
List<TopWifiVo> list13 = new ArrayList<TopWifiVo>();
TopWifiVo obj14 = new TopWifiVo();
list13.add(obj14);
obj14.setMacAddr("C0:E0:D0:E0:C0:0F");
obj14.setSsid("OFFICE-WiFi");
obj14.setCorpId("123dfd");
obj1.setWifis(list13);
obj1.setDisableCheckWithoutSchedule(false);
obj1.setFreecheckWorkDays(new Long[] { 1,2,3,4,5,6,0 };
);
obj1.setFreecheckDayStartMinOffset(240L);
obj1.setDisableCheckWhenRest(false);
obj1.setEnablePositionBle(false);
List<TopAtBleDeviceVO> list16 = new ArrayList<TopAtBleDeviceVO>();
TopAtBleDeviceVO obj17 = new TopAtBleDeviceVO();
list16.add(obj17);
obj17.setDeviceId(1311089987L);
obj1.setBleDeviceList(list16);
req.setTopGroup(obj1);
OapiAttendanceGroupAddResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/group/add");
OapiAttendanceGroupAddRequest req = new OapiAttendanceGroupAddRequest();
req.OpUserId = "123dfd";
OapiAttendanceGroupAddRequest.TopGroupVoDomain obj1 = new OapiAttendanceGroupAddRequest.TopGroupVoDomain();
obj1.Owner = "123dfdf";
obj1.EnableEmpSelectClass = true;
obj1.CorpId = "dingdfe";
obj1.SkipHolidays = true;
obj1.SpecialDays = "{\"onDuty\":{1400000:123,1400001:123},\"offDuty\":[1400000,1400001]}";
obj1.EnableOutsideCameraCheck = true;
List<OapiAttendanceGroupAddRequest.TopPositionVoDomain> list3 = new List<OapiAttendanceGroupAddRequest.TopPositionVoDomain>();
OapiAttendanceGroupAddRequest.TopPositionVoDomain obj4 = new OapiAttendanceGroupAddRequest.TopPositionVoDomain();
list3.Add(obj4);
obj4.Address = "生物科技产业园区经二路21号";
obj4.CorpId = "123dfd";
obj4.Latitude = "36.687495";
obj4.Accuracy = "0";
obj4.Title = "青藏高原自然博物馆";
obj4.Longitude = "101.750329";
obj1.Positions= list3;
obj1.ModifyMember = true;
obj1.Type = "TURN";
obj1.EnableFaceCheck = true;
obj1.CheckNeedHealthyCode = true;
obj1.EnableCameraCheck = true;
List<OapiAttendanceGroupAddRequest.TopShiftVoDomain> list6 = new List<OapiAttendanceGroupAddRequest.TopShiftVoDomain>();
OapiAttendanceGroupAddRequest.TopShiftVoDomain obj7 = new OapiAttendanceGroupAddRequest.TopShiftVoDomain();
list6.Add(obj7);
obj7.Id = 123L;
obj1.ShiftVoList= list6;
obj1.EnableOutsideCheck = true;
List<OapiAttendanceGroupAddRequest.TopMemberVoDomain> list9 = new List<OapiAttendanceGroupAddRequest.TopMemberVoDomain>();
OapiAttendanceGroupAddRequest.TopMemberVoDomain obj10 = new OapiAttendanceGroupAddRequest.TopMemberVoDomain();
list9.Add(obj10);
obj10.Role = "Attendance";
obj10.CorpId = "123dfd";
obj10.Type = "StaffMember";
obj10.UserId = "1212jfkd";
obj1.Members= list9;
obj1.Name = "白班考勤";
obj1.Id = 123L;
obj1.EnableNextDay = false;
obj1.ManagerList = ""userId1","userId2"";
obj1.WorkdayClassList = new long[] { 12,12,12,12,12,0,0 };
;
obj1.DefaultClassId = 1234L;
obj1.Offset = 500L;
OapiAttendanceGroupAddRequest.TopGroupManageRolePermissionVoDomain obj11 = new OapiAttendanceGroupAddRequest.TopGroupManageRolePermissionVoDomain();
obj11.Schedule = "w";
obj11.GroupMember = "w";
obj11.GroupType = "r";
obj11.CheckTime = "w";
obj11.CheckPositionType = "r";
obj11.OverTimeRule = "r";
obj11.CameraCheck = "w";
obj11.OutSideCheck = "w";
obj1.ResourcePermissionMap= obj11;
List<OapiAttendanceGroupAddRequest.TopWifiVoDomain> list13 = new List<OapiAttendanceGroupAddRequest.TopWifiVoDomain>();
OapiAttendanceGroupAddRequest.TopWifiVoDomain obj14 = new OapiAttendanceGroupAddRequest.TopWifiVoDomain();
list13.Add(obj14);
obj14.MacAddr = "C0:E0:D0:E0:C0:0F";
obj14.Ssid = "OFFICE-WiFi";
obj14.CorpId = "123dfd";
obj1.Wifis= list13;
obj1.DisableCheckWithoutSchedule = false;
obj1.FreecheckWorkDays = new long[] { 1,2,3,4,5,6,0 };
;
obj1.FreecheckDayStartMinOffset = 240L;
obj1.DisableCheckWhenRest = false;
obj1.EnablePositionBle = false;
List<OapiAttendanceGroupAddRequest.TopAtBleDeviceVODomain> list16 = new List<OapiAttendanceGroupAddRequest.TopAtBleDeviceVODomain>();
OapiAttendanceGroupAddRequest.TopAtBleDeviceVODomain obj17 = new OapiAttendanceGroupAddRequest.TopAtBleDeviceVODomain();
list16.Add(obj17);
obj17.DeviceId = 1311089987L;
obj1.BleDeviceList= list16;
req.TopGroup_ = obj1;
OapiAttendanceGroupAddResponse 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 OapiAttendanceGroupAddRequest;
$req->setOpUserId("123dfd");
$top_group = new TopGroupVo;
$top_group->owner="123dfdf";
$top_group->enable_emp_select_class="true";
$top_group->corp_id="dingdfe";
$top_group->skip_holidays="true";
$top_group->special_days="{\"onDuty\":{1400000:123,1400001:123},\"offDuty\":[1400000,1400001]}";
$top_group->enable_outside_camera_check="true";
$positions = new TopPositionVo;
$positions->address="生物科技产业园区经二路21号";
$positions->corp_id="123dfd";
$positions->latitude="36.687495";
$positions->accuracy="0";
$positions->title="青藏高原自然博物馆";
$positions->longitude="101.750329";
$top_group->positions = array($positions);
$top_group->modify_member="true";
$top_group->type="TURN";
$top_group->enable_face_check="true";
$top_group->check_need_healthy_code="true";
$top_group->enable_camera_check="true";
$shift_vo_list = new TopShiftVo;
$shift_vo_list->id="123";
$top_group->shift_vo_list = array($shift_vo_list);
$top_group->enable_outside_check="true";
$members = new TopMemberVo;
$members->role="Attendance";
$members->corp_id="123dfd";
$members->type="StaffMember";
$members->user_id="1212jfkd";
$top_group->members = array($members);
$top_group->name="白班考勤";
$top_group->id="123";
$top_group->enable_next_day="false";
$top_group->manager_list="[\"userId1\",\"userId2\"]";
$top_group->workday_class_list="[12,12,12,12,12,0,0]";
$top_group->default_class_id="1234";
$top_group->offset="500";
$resource_permission_map = new TopGroupManageRolePermissionVo;
$resource_permission_map->schedule="w";
$resource_permission_map->group_member="w";
$resource_permission_map->group_type="r";
$resource_permission_map->check_time="w";
$resource_permission_map->check_position_type="r";
$resource_permission_map->over_time_rule="r";
$resource_permission_map->camera_check="w";
$resource_permission_map->out_side_check="w";
$top_group->resource_permission_map = $resource_permission_map;
$wifis = new TopWifiVo;
$wifis->mac_addr="C0:E0:D0:E0:C0:0F";
$wifis->ssid="OFFICE-WiFi";
$wifis->corp_id="123dfd";
$top_group->wifis = array($wifis);
$top_group->disable_check_without_schedule="false";
$top_group->freecheck_work_days="[1,2,3,4,5,6,0]";
$top_group->freecheck_day_start_min_offset="240";
$top_group->disable_check_when_rest="false";
$top_group->enable_position_ble="false";
$ble_device_list = new TopAtBleDeviceVO;
$ble_device_list->device_id="1311089987";
$top_group->ble_device_list = array($ble_device_list);
$req->setTopGroup($top_group);
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/attendance/group/add");

curl -X POST "https://oapi.dingtalk.com/topapi/attendance/group/add" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=7de3f783-20fd-4274-82e2-f5192b63e0af' \
-d 'op_user_id=123dfd' \
-d 'top_group=null'

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

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

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

响应示例

JSON示例

{
    "result":{
        "name":"白班考勤",
        "id":23
    },
    "success":true,
    "errcode":0,
    "errmsg":"demo"
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

用户反馈

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

联系方式

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

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

提交反馈

用户反馈

感谢您的反馈！

用户反馈

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

钉钉API

dingtalk.oapi.attendance.group.add (考勤组写入)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈