飞书个人ID在哪里查看？

Question

如何在飞书（Lark）中查看个人ID？许多用户在对接第三方系统或配置API时需要获取自己的飞书个人ID（User ID），但不清楚具体查看路径。该ID是一串唯一标识用户的字母与数字组合，不同于手机号或邮箱。常见问题包括：在手机端和桌面端均找不到入口、误将OpenID当作UserID使用、或通过旧版界面操作导致信息错误。正确方法需进入“我的资料”页面，通过特定操作复制ID，或调用飞书开放平台接口获取。部分企业管理员也常因权限问题无法批量导出成员ID，影响系统集成进度。

Answer 1

一、飞书个人ID（User ID）概述与核心概念

在飞书（Lark）生态中，User ID 是系统为每个用户分配的唯一标识符，通常由字母和数字组成，如 ou_8a9b7c6d5e4f3g2h1i。它不同于用户的手机号、邮箱或昵称，是API调用、身份认证、数据同步等集成场景中的关键字段。

常见的误区包括：

• 将 OpenID 或 UnionID 误认为 User ID
• 依赖旧版界面路径查找导致信息滞后
• 未区分企业内应用与个人应用的身份体系

User ID 在以下场景中至关重要：

1. 第三方系统对接（如CRM、HR系统）
2. 自动化流程触发（如审批流绑定）
3. 权限控制与审计日志追踪
4. 批量数据导入导出时的身份映射

二、普通用户获取个人User ID的操作路径

目前飞书官方未在常规设置中直接展示User ID，但可通过“我的资料”页面间接获取。

平台	操作步骤	注意事项
桌面端（Windows/Mac）	点击左上角头像 → 进入「我的资料」→ 鼠标悬停在ID区域 → 出现「复制」按钮 → 点击复制User ID	需确保客户端为最新版本，否则可能无复制功能
移动端（iOS/Android）	进入「我」→ 点击头像进入资料页 → 向下滑动至“账号信息” → 查看并长按ID字段复制	部分版本需更新至v7.0以上才支持显示
Web端	登录飞书网页版 → 右上角头像 → 「我的资料」→ 悬浮显示User ID → 点击复制	建议使用Chrome浏览器以避免兼容问题

三、通过飞书开放平台API获取User ID的技术方案

对于开发者或需要程序化获取User ID的场景，推荐使用飞书开放平台提供的接口。

// 示例：通过手机号获取用户User ID
POST https://open.feishu.cn/open-apis/user/v1/user/find_by_mobile

Headers:
  Authorization: Bearer <access_token>
  Content-Type: application/json

Body:
{
  "mobile": "[phone]"
}

Response:
{
  "data": {
    "user": {
      "user_id": "ou_8a9b7c6d5e4f3g2h1i",
      "name": "张三",
      "mobile": "[phone]"
    }
  }
}

关键参数说明：

• access_token：需通过企业自建应用获取，权限范围应包含contact:user.employee_id:readonly
• 支持查询方式：手机号、邮箱、OpenID
• 返回结果中的user_id即为标准User ID

四、企业管理员批量获取成员User ID的实践方法

当需要为系统集成准备全量用户映射表时，管理员可采用以下两种主流方式：

1. 使用「用户列表导出」功能（需管理员权限）
2. 调用分页接口 /open-apis/contact/v3/users 迭代获取

以下是批量获取的Python示例代码：

import requests

def get_all_users(tenant_access_token):
    url = "https://open.feishu.cn/open-apis/contact/v3/users"
    headers = {"Authorization": f"Bearer {tenant_access_token}"}
    users = []
    page_token = None

    while True:
        params = {"page_size": 100}
        if page_token:
            params["page_token"] = page_token

        response = requests.get(url, headers=headers, params=params)
        data = response.json()

        users.extend([
            {"name": u["name"], "user_id": u["user_id"], "email": u.get("email")}
            for u in data["data"]["items"]
        ])

        page_token = data["data"].get("page_token")
        if not page_token:
            break

    return users

五、常见问题分析与解决方案对比

在实际项目中，常出现因User ID获取错误导致集成失败的情况。以下是典型问题与应对策略：

问题现象	根本原因	解决方案
API返回“用户不存在”	传入了OpenID而非User ID	确认字段来源，使用user_id字段
无法复制User ID	客户端版本过低或权限不足	升级至最新版并检查组织架构可见性设置
批量导出缺失部分成员	分页未处理完整或部门过滤条件限制	结合department_id递归遍历所有子部门
获取到的ID格式异常	混淆了加密UserID与明文UserID	确认应用是否启用了UserID加密模式

六、高级场景：跨应用身份关联与ID映射管理

在复杂系统集成中，往往涉及多个身份标识之间的映射关系。飞书提供三种主要ID类型：

1. User ID：企业内唯一用户标识（最常用）
2. OpenID：应用级唯一标识，同一用户在不同应用中OpenID不同
3. UnionID：跨企业全局唯一标识，适用于多租户SaaS产品

以下为身份映射的Mermaid流程图：

graph TD
    A[用户登录飞书] --> B{是否同一企业?}
    B -- 是 --> C[使用User ID进行内部系统匹配]
    B -- 否 --> D{是否启用UnionID权限?}
    D -- 是 --> E[通过UnionID实现跨企业身份统一]
    D -- 否 --> F[仅能使用OpenID做应用级识别]
    C --> G[完成身份绑定与数据同步]
    E --> G
    F --> H[限制跨组织协作能力]