更新考勤组成员
POST
/topapi/attendance/group/member/update最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口更新考勤组成员,支持新增或删除人员、部门、无需考勤人员。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
op_user_id
string
必需
操作人userid。
group_id
number
必需
考勤组ID。如果你使用的是旧考勤组标识即group_key,可以调用groupKey转换为groupId接口将group_key转换为group_id。
schedule_flag
number
必需
从哪天开始排班:0:从今天开始排班1:从明天开始排班
update_param
object
更新考勤组信息。
remove_extra_users
array[string]
可选
删除无需考勤的成员,没有的话,无需赋值。
remove_depts
array[string]
可选
删除考勤部门,没有的话,无需赋值。
remove_users
array[string]
可选
删除考勤人员,没有的话,无需赋值。
add_depts
array[string]
可选
添加考勤部门,没有的话,无需赋值。
add_users
array[string]
可选
添加考勤人员,没有的话,无需赋值。
add_extra_users
array[string]
可选
添加无需考勤的人员,没有的话,无需赋值。
示例
{
"op_user_id": "user123",
"group_id": "98562",
"update_param": {
"add_depts": [
"123"
],
"add_extra_users": [
"user456"
],
"add_users": [
"user123"
],
"remove_depts": [
"456"
],
"remove_extra_users": [
"user789"
],
"remove_users": [
"user121"
]
},
"schedule_flag": "0"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
request_id
string
请求ID。
errcode
number
返回码。
success
boolean
成功标记。
示例
{
"request_id": "string",
"errcode": 0,
"success": true
}
最后修改时间: 2 年前