飞书组织架构与 ID 转换 通过 Contact v3 API 实现成员搜索、部门管理和 ID 转换。 --- API 基础 Base URL : 认证 : 认证与 Token 获取 从 根目录执行共享脚本: 请求头统一使用 。 如果业务接口返回 token 无效、过期或 401,强制刷新后仅重试一次原请求: 环境变量 : - - 本地缓存 : (未过期直接复用,默认提前 5 分钟刷新) --- 成员查询 | API | 端点 | 说明 | |-----|------|------| | 搜索成员 | | 通过邮箱/手机号获取 OpenID | | 获取职务 | | 需在管理后台预先维护 | --- 部门管理 | API | 端点 | 方法 | 请求体示例 | 说明 | |-----|------|------|-----------|------| | 获取部门 | | GET | - | 查询单个部门详情 | | 获取部门列表 | | GET | - | 支持 参数 | | 获取父部门路径 | | GET | - | 获取部门层级路径 | | 创建部门 | | POST | | 需管理员权限 | | 更新部门 | | PUT | | 修改部门信息 | | 删除部门 | | DELETE | - | 删除空部门 | | 入职成员 | | POST | | 创建用户 | | 更新…