SuperAPI AI 工具集

feishu-contact

通用与其它

查看项目

更新于 10-15 19:54

技能介绍

用途:通过飞书 Contact v3 API 管理组织架构并完成 ID 转换,覆盖成员、部门、用户组、职级、角色等通讯录对象。

主要能力:成员搜索与批量获取 ID(邮箱/手机号换 OpenID);部门增删改查及父部门路径查询;用户入职、更新、删除与列表过滤;用户组、职级、角色及其成员的增删改查;ID 转换(open_id 应用内唯一、user_id 企业内唯一、union_id 跨应用唯一);职务、办公地点、人员类型、自定义属性、授权范围查询;订阅 17 类通讯录变更事件(用户/部门/人员类型/职级的创建、更新、删除)。

使用方式:Base URL 为 https://open.feishu.cn/open-apis/contact/v3,认证头 Authorization: Bearer {tenant_access_token}。从 feishu_skills 根目录执行共享脚本获取 Token:TOKEN="$(./scripts/get_feishu_token.sh)";若返回 401 或 token 失效,强制刷新后仅重试一次:TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"。需配置环境变量 FEISHU_APP_ID、FEISHU_APP_SECRET,本地缓存 ./.feishu_token_cache.json 未过期直接复用,默认提前 5 分钟刷新。ID 转换建议直接调用 GET /users/{user_id} 一次性获取全部 ID 类型,如 GET /contact/v3/users/ou_xxx?user_id_type=open_id。

适用场景:企业内部系统对接、人员地理分布分析、供应商/外包访问权限控制、组织架构同步。

限制:创建部门和入职成员需最高权限,建议预发环境测试;组织架构变更必须预发测试;职务需在管理后台预先维护;删除部门仅限空部门;缓存常用 ID 可减少 API 调用。具体收费与价格暂未提供。