更新考勤组
POST
/topapi/attendance/group/modify最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口根据考勤组id更新考勤组信息。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端API授权凭证,可通过获取企业内部应用的access_token接口获取。
示例值:
b5e95d101165xxxx
Body 参数application/json
op_user_id
string
必需
操作人userId。
top_group
object
考勤组信息。
shift_vo_list
array [object {1}]
班次信息。
id
number
必需
考勤组ID。如果你使用的是旧考勤组标识即group_key,可以调用groupKey转换为groupId接口将group_key转换为group_id。
name
string
考勤组名称。
positions
array [object {6}]
考勤设置。
offset
number
考勤范围。
enable_face_check
boolean
可选
是否开启人脸检测。true:开启false(默认):关闭
manager_list
array[string]
可选
考勤组子管理员userid列表。
enable_camera_check
boolean
可选
是否开启拍照打卡。true:开启false(默认):关闭
owner
string
考勤组负责人。
disable_check_when_rest
boolean
可选
休息日打卡是否需审批。true:需要false:不需要
skip_holidays
boolean
可选
是否跳过节假日。true(默认):跳过false:不跳过
enable_outside_check
boolean
可选
是否可以外勤打卡。true(默认):允许false:不允许
disable_check_without_schedule
boolean
可选
未排班时是否禁止员工打卡。
workday_class_list
array[number]
可选
周班次列表。固定班制必填,0表示休息。
enable_emp_select_class
boolean
可选
未排班时是否允许员工选择班次打卡。
resource_permission_map
object
可选
子管理员权限范围。w:可管理r:可读
示例
{
"op_user_id": "user1",
"top_group": {
"owner": "user1",
"enable_emp_select_class": true,
"corp_id": "dinge8xxxx",
"skip_holidays": true,
"positions": [
{
"address": "生物科技产业园区经二路21号",
"latitude": "36.687495",
"accuracy": "0",
"title": "青藏高原自然博物馆",
"corp_id": "dinge8xxxx",
"longitude": "101.750329"
}
],
"enable_face_check": true,
"shift_vo_list": [
{
"id": 678215070
}
],
"enable_outside_check": true,
"name": "白班考勤",
"manager_list": [
"userId1"
],
"offset": 500,
"workday_class_list": [
12,
12,
12,
12,
12,
0,
0
]
}
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
object
调用结果。
name
string
考勤组名称。
id
number
考勤组ID。
errmsg
string
返回码描述。
errcode
number
返回码。
success
boolean
是否调用成功。
request_id
string
请求ID。
示例
{
"result": {
"name": "string",
"id": 0
},
"errmsg": "string",
"errcode": 0,
"success": true,
"request_id": "string"
}
最后修改时间: 2 年前