更新考勤组

POST

http://127.0.0.1/topapi/attendance/group/modify

服务端API/考勤/考勤组管理

最后修改时间：2022-08-30 09:19:22

责任人：未设置

说明

调用本接口根据考勤组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}]

班次信息。

可选

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
    ]
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/topapi/attendance/group/modify?access_token=b5e95d101165xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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成功

application/json

Body

result

object

调用结果。

可选

name

string

考勤组名称。

可选

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"
}

创建考勤组

删除考勤组

更新考勤组

说明#

权限#

请求参数

示例代码

返回响应

说明

权限