Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
服务端API
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
  1. 考勤组管理
  • 考勤组管理
    • 批量获取考勤组详情
      POST
    • 获取用户考勤组
      POST
    • 获取考勤组成员
      POST
    • 考勤组成员校验
      POST
    • 更新考勤组成员
      POST
    • 获取考勤组员工的userid
      POST
    • 批量获取考勤组摘要
      POST
    • 获取考勤组详情
      POST
    • 搜索考勤组摘要
      POST
    • 批量新增wifi信息
      POST
    • 批量移除wifi
      POST
    • 批量查询wifi
      POST
    • 批量新增position
      POST
    • 批量删除position
      POST
    • 批量查询position
      POST
    • 创建考勤组
      POST
    • 更新考勤组
      POST
    • 删除考勤组
      POST
    • 批量新增考勤组成员
      POST
    • 批量删除考勤组成员
      POST
    • 查询考勤组员工
      POST
    • 根据groupkey查询考勤组信息
      POST
    • groupKey转换为groupId
      POST
    • groupId转换为groupKey
      POST
  • 考勤打卡
    • 获取打卡结果
      POST
    • 获取打卡详情
      POST
    • 上传打卡记录
      POST
  • 考勤班次
    • 创建班次
    • 查询历史班次
    • 删除班次
    • 修改卡点设置
    • 按名称搜索班次
    • 获取班次详情
    • 获取班次摘要信息
  • 考勤排班
    • 查询成员排班信息
    • 批量查询人员排班信息
    • 排班制考勤组排班
    • 查询排班打卡结果
    • 查询企业考勤排班详情
    • 查询排班概要信息
  • 考勤统计
    • 获取考勤报表列定义
    • 获取考勤报表列值
    • 获取报表假期数据
    • 查询是否启用智能统计报表
    • 获取用户考勤数据
  • 考勤机管理
    • 查询员工智能考勤机列表
  • 假勤审批
    • 通知审批通过
    • 通知审批撤销
    • 通知补卡通过
    • 预计算时长
    • 通知换班通过
    • 计算请假时长
    • 查询请假状态
  • 假期管理
    • 添加假期类型
    • 删除假期类型
    • 更新假期类型
    • 查询假期类型
    • 初始化假期余额
    • 查询假期余额
    • 批量更新假期余额
    • 查询假期消费记录
  1. 考勤组管理

创建考勤组

POST
http://127.0.0.1/topapi/attendance/group/add
最后修改时间:2022-08-30 09:19:22
责任人:未设置

说明#

调用本接口创建考勤组。
服务地址:https://oapi.dingtalk.com

权限#

服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型是否可调用权限申请方式API Explorer调试
企业内部应用是开发者后台申请调试
第三方企业应用否——
第三方个人应用否——

请求参数

Query 参数

Body 参数application/json

示例
{
    "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"
    }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/topapi/attendance/group/add?access_token=4c9d5xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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成功
application/json
Body

示例
{
    "result": {
        "name": "string",
        "id": 0
    },
    "success": true,
    "errcode": 0,
    "errmsg": "string",
    "": {}
}
修改于 2022-08-30 09:19:22
上一页
批量查询position
下一页
更新考勤组
Built with