钉钉开放API文档

基础地址: https://ai.jiuqi.top/api/dingtalk | 鉴权方式: Header Authorization: Bearer <api_key>

快速导航

鉴权说明 人员管理 部门管理 考勤月报 考勤日报 审批管理 离职管理 数据查询 全量同步 错误码

鉴权说明

所有API接口需要在请求Header中携带API Key：

Authorization: Bearer <your_api_key>

响应格式：

{ "code": 0, "message": "success", "data": {...} }
一、人员信息管理
POST/employees/sync同步全部在职员工信息

说明：从钉钉同步全部在职员工的姓名、手机号、部门、职位等信息到本地数据库。

curl -X POST 'https://ai.jiuqi.top/api/dingtalk/employees/sync' -H 'Authorization: Bearer <your_api_key>'
POST/employees/sync/{userid}同步单个员工信息
curl -X POST 'https://ai.jiuqi.top/api/dingtalk/employees/sync/用户ID' -H 'Authorization: Bearer <your_api_key>'
POST/employees/roster/sync同步全部花名册信息

说明：同步在职员工的身份证、学历、合同、银行卡等花名册扩展信息。

curl -X POST 'https://ai.jiuqi.top/api/dingtalk/employees/roster/sync' -H 'Authorization: Bearer <your_api_key>'
POST/employees/roster/sync/{userid}同步单个员工花名册
curl -X POST 'https://ai.jiuqi.top/api/dingtalk/employees/roster/sync/用户ID' -H 'Authorization: Bearer <your_api_key>'
二、部门管理
POST/departments/sync同步全部部门信息
curl -X POST 'https://ai.jiuqi.top/api/dingtalk/departments/sync' -H 'Authorization: Bearer <your_api_key>'
三、考勤月报管理
POST/attendance/monthly/sync同步某月全部员工考勤（异步）
参数类型说明
year_monthstring年月YYYY-MM，默认上个月
curl -X POST 'https://ai.jiuqi.top/api/dingtalk/attendance/monthly/sync' -H 'Authorization: Bearer <your_api_key>' -H 'Content-Type: application/json' -d '{"year_month": "2026-05"}'
POST/attendance/monthly/sync/{userid}同步某人某月考勤
curl -X POST 'https://ai.jiuqi.top/api/dingtalk/attendance/monthly/sync/用户ID' -H 'Authorization: Bearer <your_api_key>' -H 'Content-Type: application/json' -d '{"year_month": "2026-05"}'
GET/attendance/monthly查询考勤月报数据
参数类型说明
year_monthstring年月YYYY-MM
departmentstring部门名称（模糊匹配）
namestring姓名关键字
pageint页码，默认1
page_sizeint每页条数，默认50
curl 'https://ai.jiuqi.top/api/dingtalk/attendance/monthly?year_month=2026-05&page=1&page_size=10' -H 'Authorization: Bearer <your_api_key>'
GET/attendance/monthly/export导出考勤Excel
curl 'https://ai.jiuqi.top/api/dingtalk/attendance/monthly/export?year_month=2026-05' -H 'Authorization: Bearer <your_api_key>' -o 考勤月报.xlsx
四、考勤日报
POST/attendance/daily/sync同步某天打卡记录
参数类型说明
work_datestring日期YYYY-MM-DD，默认今天
curl -X POST 'https://ai.jiuqi.top/api/dingtalk/attendance/daily/sync' -H 'Authorization: Bearer <your_api_key>' -H 'Content-Type: application/json' -d '{"work_date": "2026-05-30"}'
五、审批/请假管理
POST/approval/sync同步某时间段审批记录
参数类型必填说明
start_timestring必填开始日期YYYY-MM-DD
end_timestring必填结束日期YYYY-MM-DD
curl -X POST 'https://ai.jiuqi.top/api/dingtalk/approval/sync' -H 'Authorization: Bearer <your_api_key>' -H 'Content-Type: application/json' -d '{"start_time": "2026-05-01", "end_time": "2026-05-31"}'
六、离职人员管理
POST/dimission/sync同步离职人员信息
参数类型说明
days_backint查询天数，默认180
curl -X POST 'https://ai.jiuqi.top/api/dingtalk/dimission/sync' -H 'Authorization: Bearer <your_api_key>' -H 'Content-Type: application/json' -d '{"days_back": 180}'
GET/dimission/list查询离职人员列表
curl 'https://ai.jiuqi.top/api/dingtalk/dimission/list?page=1&page_size=10' -H 'Authorization: Bearer <your_api_key>'
七、数据查询
GET/employees查询员工列表
参数类型说明
statusstringactive/left
departmentstring部门名称
namestring姓名关键字
pageint页码
page_sizeint每页条数
curl 'https://ai.jiuqi.top/api/dingtalk/employees?status=active&page=1&page_size=10' -H 'Authorization: Bearer <your_api_key>'
GET/departments查询部门树形列表
curl 'https://ai.jiuqi.top/api/dingtalk/departments' -H 'Authorization: Bearer <your_api_key>'
GET/sync/logs查询同步日志
curl 'https://ai.jiuqi.top/api/dingtalk/sync/logs?page=1&page_size=20' -H 'Authorization: Bearer <your_api_key>'
八、一键全量同步
POST/sync/all一键全量同步（异步）

说明：按顺序执行：部门→员工→花名册→考勤→审批→离职

curl -X POST 'https://ai.jiuqi.top/api/dingtalk/sync/all' -H 'Authorization: Bearer <your_api_key>' -H 'Content-Type: application/json' -d '{"year_month": "2026-05"}'

错误码说明

code说明
0成功
400参数错误
401缺少API Key
403API Key无效
500服务器内部错误

文档最后更新时间：2026-08-17 02:13:33