企业级钉钉开放平台API集成方案，覆盖组织架构查询、机器人消息推送、OA审批全流程管理，需配置App Key/Secret认证
说明：
## 核心用法
本 Skill 提供钉钉开放平台 30+ 个 API 的封装调用，分为四大功能模块：
**组织架构管理**：支持用户搜索（姓名/手机号/unionid）、用户详情查询、部门树遍历（父部门/子部门/部门用户列表）、员工人数统计、未登录用户查询、离职记录查询。根部门 deptId 固定为 1，支持自动分页获取全量数据。
**消息推送能力**：通过机器人实现单聊消息发送（需 userId + robotCode）和群聊消息发送（需 openConversationId），支持查询群内机器人列表获取可用 robotCode。
**OA 审批全生命周期**：覆盖审批实例查询（ID列表/详情）、用户视角审批管理（发起/抄送/待办/已办/数量统计）、审批操作（发起/终止/同意/拒绝/转交/评论）。支持表单数据 JSON 构造和时间戳范围查询。
**技术实现**：基于 TypeScript 命令行脚本，统一错误处理格式（success + error 对象），支持 `–debug` 参数输出详细日志。
## 显著优点
– **功能全面**：覆盖钉钉最核心的通讯录、消息、审批三大 API 体系，单 Skill 解决企业自动化多数场景
– **企业级设计**：支持离职人员、未登录用户等管理场景，符合 HR/IT 部门实际需求
– **统一封装**：标准化的 JSON 输入输出，降低钉钉 API 的学习成本
– **审批自动化完整**：少有的支持审批”发起-流转-终止-评论”全流程的开源封装
## 潜在缺点与局限性
– **认证门槛**：必须预先创建钉钉应用并获取 App Key/Secret，个人开发者难以体验
– **权限依赖**：部分接口（如手机号查用户、离职记录）仅限企业内部应用，第三方应用无法调用
– **无实时能力**：纯轮询式 API 调用，不支持钉钉回调推送（如审批状态变更 webhook）
– **机器人限制**：消息发送依赖预先配置的机器人，不支持主动创建群或邀请成员
– **时间限制**：未登录用户查询只能查 1 个月内数据，且需次日 9 点后才能获取前一天数据
## 适合人群
– 企业 IT 管理员：自动化员工信息同步、离职审计
– HR 系统开发者：集成钉钉审批流，实现请假/报销等流程自动化
– 运维/行政人员：批量发送通知消息、统计组织架构数据
– 低代码平台集成者：通过命令行封装快速对接钉钉能力
## 常规风险
**数据隐私合规**：直接处理员工手机号、邮箱、部门架构等敏感信息，需确保符合《个人信息保护法》和企业内部数据规范。
**权限越界风险**：审批操作（同意/拒绝/终止）具有业务法律效力，自动化脚本需配合严格的审批策略和日志审计。
**Token 安全管理**：App Secret 泄露将导致全量 API 权限被盗用，环境变量方式在生产环境需配合密钥管理系统（KMS）。
**频率限制风险**：钉钉 API 存在调用频次限制（如获取 access_token 每日 2000 次），大规模分页查询需实现指数退避重试。
会员专属
