创建考勤组
POST
/topapi/attendance/group/add最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口创建考勤组。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否可调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端接口的授权凭证,可通过调用access_token接口获得。
示例值:
4c9d5xxxx
Body 参数application/json
op_user_id
string
必需
操作人的userid。
top_group
object
考勤组信息。
owner
string
考勤组负责人。
enable_emp_select_class
boolean
可选
未排班时是否允许员工选择班次打卡。
corp_id
string
可选
企业的corpId,可以在开发者后台获取。
skip_holidays
boolean
可选
是否跳过节假日。true:跳过(默认值)false:不跳过
special_days
string
特殊日期配置。
enable_outside_camera_check
boolean
可选
是否开启外勤打卡必须拍照。true:开启false:关闭(默认值)
positions
array [object {6}]
考勤设置。
modify_member
boolean
可选
是否有修改考勤组成员相关信息。
type
string
必需
考考勤组类型:FIXED:固定班制考勤组TURN:排班制考勤组NONE:自由工时考勤组
enable_face_check
boolean
可选
是是否开启人脸检测。true:开启false:关闭(默认值)
check_need_healthy_code
boolean
可选
打卡是否需要健康码:true:开启false:关闭(默认值)
enable_camera_check
boolean
可选
是否开启拍照打卡。true:开启false:关闭(默认值)
shift_vo_list
array [object {1}]
班次信息。
enable_outside_check
boolean
可选
是否可以外勤打卡。true:允许(默认值)false:不允许
members
array [object {4}]
考勤组成员。
name
string
考勤组名。
id
number
考勤组ID。
enable_next_day
boolean
可选
是否第二天生效。true:是false:否
manager_list
array[string]
可选
考勤组子管理员userid列表。
workday_class_list
array[number]
可选
周班次列表。固定班制必填,0表示休息。
default_class_id
number
可选
默认班次ID。固定班制必填。
offset
number
考勤范围。
resource_permission_map
object
可选
子管理员权限范围。w:可管理r:可读
wifis
array [object {3}]
考勤wifi打卡。
disable_check_without_schedule
boolean
可选
未排班时是否禁止员工打卡。
freecheck_work_days
array[number]
可选
自由工时考勤组工作日。1:周一0:周日
freecheck_day_start_min_offset
number
可选
自由工时考勤组考勤开始时间与当天0点偏移分钟数。例如:240表示4:00。
disable_check_when_rest
boolean
可选
休息日打卡是否需审批:true:需要 false:不需要
enable_position_ble
boolean
是否启用蓝牙定位。
ble_device_list
array [object {1}]
蓝牙打卡信息。
示例
{
"op_user_id": "123dfd",
"top_group": {
"wifis": [
{
"mac_addr": "C0:E0:D0:E0:C0:0F",
"ssid": "OFFICE-WiFi",
"corp_id": "123dfd"
}
],
"enable_camera_check": "true",
"freecheck_day_start_min_offset": "240",
"special_days": "{\"onDuty\":{1400000:123,1400001:123},\"offDuty\":[1400000,1400001]}",
"enable_next_day": "false",
"shift_vo_list": [
{
"id": "123"
}
],
"disable_check_when_rest": "false",
"type": "TURN",
"disable_check_without_schedule": "false",
"modify_member": "true",
"check_need_healthy_code": "true",
"members": [
{
"role": "Attendance",
"user_id": "1212jfkd",
"type": "StaffMember",
"corp_id": "123dfd"
}
],
"enable_position_ble": "false",
"id": "123",
"manager_list": "[\"userId1\",\"userId2\"]",
"owner": "123dfdf",
"skip_holidays": "true",
"offset": "500",
"positions": [
{
"address": "生物科技产业园区经二路21号",
"latitude": "36.687495",
"accuracy": "0",
"title": "青藏高原自然博物馆",
"corp_id": "123dfd",
"longitude": "101.750329"
}
],
"default_class_id": "1234",
"enable_face_check": "true",
"ble_device_list": [
{
"device_id": "1311089987"
}
],
"enable_outside_camera_check": "true",
"freecheck_work_days": "[1,2,3,4,5,6,0]",
"enable_outside_check": "true",
"workday_class_list": "[12,12,12,12,12,0,0]",
"name": "白班考勤",
"resource_permission_map": [
{
"schedule": "w",
"out_side_check": "w",
"group_type": "r",
"group_member": "w",
"check_position_type": "r",
"camera_check": "w",
"check_time": "w",
"over_time_rule": "r"
}
],
"corp_id": "dingdfe",
"enable_emp_select_class": "true"
}
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
object
调用结果。
name
string
考勤组名。
id
number
考勤组id。
success
boolean
是否成功。
errcode
number
返回码。
errmsg
string
返回码描述。
object
请求ID。
示例
{
"result": {
"name": "string",
"id": 0
},
"success": true,
"errcode": 0,
"errmsg": "string",
"": {}
}
最后修改时间: 2 年前