用途:该技能负责钉钉通讯录的查询操作,覆盖搜索用户、查用户详情、搜索部门、列部门成员、查部门路径、统计员工数等任务;入口为同目录下的 scripts/dt_helper.sh。
主要能力:按关键词搜索用户、获取用户完整详情、unionId 与 userId 转换、查询企业员工总人数、按关键词搜索部门、获取子部门列表与子部门 ID 列表、获取部门详情、获取部门成员完整列表与 userId 列表、获取用户所在部门路径,以及错误码与所需应用权限查询。
使用方式:先识别任务类型,再用 bash scripts/dt_helper.sh --get KEY 校验本次任务必需配置,通用必填为 DINGTALK_APP_KEY、DINGTALK_APP_SECRET;涉及以操作者为起点的任务另需 DINGTALK_MY_USER_ID。缺配置时一次性询问并用 bash scripts/dt_helper.sh --set KEY=VALUE 写入;随后直接调用脚本获取 Token,api.dingtalk.com 用 --token,oapi.dingtalk.com 用 --old-token;简单操作直接执行,复杂操作写临时文件执行,禁止 heredoc。API 细节可用 grep -A 30 "^## 1. 按关键词搜索用户" references/api.md 一类命令从 references/api.md 提取对应章节。
限制:仅在通过本次任务配置校验后方可进入 API 调用;凭证不得完整打印,确认时只显示前 4 位加 ****;dt_helper 仅按时间缓存 token,若返回 errcode 40001/40014 需用 --nocache 强制重新获取。userId 即 staffId,为企业内部员工 ID,管理后台通讯录成员管理中查看姓名获取;unionId 为跨企业/跨应用唯一标识,可通过 bash scripts/dt_helper.sh --to-unionid <userid> 获取。费用、平台与更多步骤暂未提供。