用户身份体系
不同类型的用户 ID
| ID | 是否支持 | 定义 |
|---|---|---|
| user_id（与智书合同之外的三方系统对接，目前只能选这种方式） | 支持，需单独授权自建应用 | 用户从飞书组织架构内获取的user_id |
| open_id | 不支持 | 用户从飞书组织架构内获取的open_id，（在对接智书合同时）无意义，不能用 |
| lark_user_id（限自建应用版智书合同） | 支持 | 用户从飞书组织架构内获取的user_id。注意：仅限客户使用自建应用的智书合同时，而不是使用ISV应用的合同时 |
| lark_open_id | 不支持 | 用户从飞书组织架构内获取的open_id，（在对接智书合同时）无意义，不能用 |
| lark_union_id（限智书内部） | 支持 | 用户从飞书组织架构内获取的union_id。注意：仅限智书企飞ISV应用调用（如烽火CRM） |
| union_id（限与智书内部SaaS服务对接，比如：烽火） | 支持，需单独授权自建应用 | 用户从飞书组织架构内获取的union_id |
| zs_user_id | 当前不支持，后续支持 | 用户从智书组织架构内获取的zs_user_id |
| zs_open_id | 当前不支持，后续支持 | 用户从智书组织架构内获取的zs_open_id |
| zs_union_id | 当前不支持，后续支持 | 用户从智书组织架构内获取的zs_union_id |
相关查询参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| user_id_type | string | 是 | 用户ID类型 详情参考：用户身份体系。示例值："user_id"。可选值有： - user_id：标识一个用户在某个租户内的身份。同一个用户在租户A和租户B内的User ID是不同的。在同一个租户内，一个用户的User ID在所有应用（包括商店应用）中都保持一致。User ID主要用于在不同的应用间打通用户数据。 - union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的Union ID是相同的，在不同开发商下的应用中的Union ID是不同的。通过Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。 |
修改于 2025-11-12 05:55:56