打开导航 
一、通讯录动作常见问题
1.通讯录动作出现错误了怎么办？
如果遇到“通讯录动作”出现问题，请点击以下链接，参考【通讯录常见问题】相关文档
【通讯录常见问题】文档：https://open.feishu.cn/document/ugTN1YjL4UTN24CO1UjN/uQzN1YjL0cTN24CN3UjN#e486e304
2.如何高效地使用通讯录接口？
通讯录模块目前包含成员、部门、用户组等几大模块，每个模块都会提供对应的api接口，便于开发者进行智能化的系统对接。开发者对于接口的使用权限主要分为三类：
1）接口的使用权限。定义应用有无权限调用该接口。
2）接口操作的数据权限。定义应用能否对某些数据进行查询或操作。
3）数据字段的权限。由于某些实体（如用户）不同字段的敏感度不同，如用户的手机号，相对比较敏感，要获取就需要额外的权限。
基于上述三个权限的认知，开发者在进行开发时，可以自行检查，提高开发效率。自行检查确认点为：
1）调用某接口时是否有接口的调用权限，如果没有，接口无法访问；
2）获取或操作某数据时，是否有该数据的通讯录权限，如果没有，会提示无权限；
3）获取某实体的具体字段时是否有该字段的权限，如果没有，可能会获取不到。
3.通讯录权限范围相关问题
1）user_accss_token 与 tenant_access_token 在访问通讯录接口时权限有什么区别？
二者使用获取或操作数据时权限过滤范围不一样。
·tenant_access_token 基于应用的通讯录范围进行权限的过滤，如调用接口获取部门 A 时，会检查部门 A 是否在应用的通讯录权限范围内。其规则配置入口为：Admin管理后台/工作台管理/应用管理。
·user_accss_token 基于用户的可见组织架构范围来做权限过滤，用户可见的组织架构范围为app端上“通讯录”“组织架构”部分可见的架构，其规则配置入口为：登陆Admin管理后台,进入“安全”“用户权限”--“组织架构可见范围”。
2）如何获取企业全部员工信息？
飞书目前没有单独的接口可以获得全部员工信息，如果需要获取，可以按照以下的步骤操作确认：
·确认应用通讯录范围是否为全员，请保证开启为全员。如果不是全员，可能无法获取到全员信息。
·确认通讯录范围为全员后，通过获取部门信息列表接口，设置参数parent_department_id=0，fetch_child=true。获取企业下所有部门ID列表。
·在步骤2获取部门ID列表的基础上，通过获取用户列表等接口搭配使用，来获得全部员工的相关信息。
3）如何获取根部门下的员工通讯录信息？
首先请确保应用的通讯录权限范围设置为“全员”或包含根部门下的所有员工，然后通过获取用户列表接口，设置参数department_id=0，获得根部门下的员工通讯录信息。
4.ID类问题
1）设定好了权限及权限使用的范围，但是仍然获取不到user_id、邮箱、手机号等信息
这里因为user_id、邮箱、手机号等信息比较敏感，需要单独申请相应的权限，无法仅仅通过“获取用户信息权限”这一个权限来获得。详情请参考应用权限文档。
2）同一个用户在多个应用的 open_id 是一样的吗？
不一样。open_id 是用户在应用内唯一标识，因此同一个用户在不同应用中的 open_id 不一致
3）用户在不同企业的 open_id 和 union_id 是不是一样的？
不一样。不同的企业内的用户应算作两个用户，因此进行区分
4）user_id（employee_id） 能不能更新呢？
你可以在创建用户将该用户在企业内部系统已存在的唯一 ID 指定为user_id，若不指定将由系统自动为用户生成一个唯一的随机 ID 作为user_id，已创建用户的 user_id（部分场景也叫 employee_id）不支持更新，因为各应用方都可能用到并保存 user_id, 如果修改 user_id 可能造成应用感知不到，从而造成应用无法使用等问题。
5）user_id 如何获取？
可以通过email或mobile换取，换取方式见接口使用手机号或邮箱获取用户 ID 或者 登录管理后台，点击用户详情，查看获取“用户 ID”。
5.用户/人员相关问题
1）我一不小心误删了部门（或者人员），能不能按照原有的 ID 进行恢复？
目前不能恢复原有的ID。企业的 ID 是唯一的，建议新增一个 ID。
2）我不明白人员的status字段，有详细的注解吗？
可以将该字段对应的数字转化为二进制，对应位数就是对应的值的状态。对照：bit0(最低位): 1冻结，0未冻结；bit1：1离职，0在职；bit2：1未激活，0已激活例：数字“2”转化为二进制就是“010”，意味着“已激活、离职、未冻结”；而数字“0”转化为二进制就是“000”，意味着“已激活、在职、未冻结”。
3）我开发了多个应用，想知道其中某个应用的用户是否也在使用我开发的其他应用。可以通过什么字段来判断？
目前可以使用字段 union_id，一个用户在同一个开发者所属的多个应用中，union_id 唯一
4）搜索用户 接口为什么获取不到返回值？
你可以通过以下方式排查原因：
- 确认你能在飞书客户端的搜索栏中搜到对应用户，且该用户不是外部用户或离职人员
- 确认请求参数 page_token 的值是否正确
5）调用手机号或邮箱获取用户 ID/获取用户信息接口时，为什么只能获取自己的，不能获取其他人员的？
请确认相关应用的通讯录权限范围包含包含要获取的用户，而不是只有你自己，如果通讯录范围不包含获取的用户，会返回邮箱或手机号不存在。
6）人员为什么有时候会被拉入其他的部门群？
可以通过如下步骤排查：
- 确认用户是否有反复修改部门
- 确认该人员是不是被拉入的部门的负责人
7）系统默认生成的userid，业务方保存userid，删除A员工之后，这个userid会不会被后面新增的员工占用?
系统默认生产成的 userid ，保证了企业内有效（无效表示已离职用户）用户唯一，开发者或管理员对用户进行删除，添加，可能会存在新添加的用户的 userid 和历史上已经删除的用户一样。所以建议增加用户的时候，用具有唯一性标示的id作为 userid ，避免造成困扰（注：部门的自定义ID同理）。
6.用户接口相关问题
1） 创建用户接口 或者 获取单个用户信息 接口请求或应答的结构体内的自定义字段应该如何理解？
用户的 custom_attrs 属性是对用户属性的扩展，用于企业根据自身需求灵活扩展用户描述能力，根据取值语法的不同主要分为文本类型、网页类型、枚举类型、图片类型、用户类型。
文本类型：类用户的 name 属性，只有一个 string 类型的 value。值对应 text 字段
网页类型: 字段引用链接，可在成员名片页实现点击跳转效果。该类型字段需要有标题文字，值对应 text 字段，需要有跳转的 url ，值对应 url 。由于PC 端的跳转链接可能会和移动端不太一样，所以单独设置了 pc_url 作为跳转的url，如果该值不填，则 PC 端链接使用 url。
枚举类型： 实现字段取值在给定选项中选择，如员工类型，包含正式、外包、顾问。企业成员的员工类型，只能在这些选项中选择，该类型的值对应 option_id ，也就是管理员配置的某个选项 key 。
图片类型 与枚举类型相似，只是选项的数据类型只能是图片，用于在成员名片页展示其对应的图片，该类型的值对应 option_id，可从管理后台查询对应的图片id。
用户类型 该类型主要用于成员名片页展示对另一用户的引用，实现成员名片页之间的跳转，如将“张三”的 HRBP 字段显示“李四”并支持点击跳转至李四的名片页。对应generic_user 下 id 为需要引用的成员 user_id, generic_user 下的 type 目前固定为1,表示用户类型。
特殊说明：请确保你的组织管理员已在 管理后台/组织架构/成员字段管理/自定义字段管理/全局设置 中开启了“允许开放平台 API 调用“，否则该字段不会生效/返回。如果创建或更新需要对用户新加自定义字段的值，请确保自定义字段的 key 已经被企业管理员创建且有效。
2）创建用户接口企业邮箱字段 enterprise_email 该如使用？
创建用户接口中 enterprise_email 字段表示设置用户的企业邮箱，由于企业邮箱的域名需要企业在管理后台申请并开启。如果企业没有开启对应域名的企业邮箱，设置用户的企业邮箱会操作失败，请联系企业的管理员确认企业是否在后台启用了该域名的企业邮箱。
3）如何理解 获取用户列表 接口？
该接口的设计含义是获取某个部门下的直属用户列表，由于数据的获取受到通讯录权限范围的检查，如果请求带上了部门ID（根部门的部门ID为0），首先会检查应用是有该部门ID的通讯录权限，如果有，就会返回该部门下的直属成员信息（如果带上了department_id=0 表示 check 有没有根部门的通讯录权限，有的话，返回根部门下直属成员信息）；如果请求没有带上部门 ID,无法进行 ID 的通讯录权限校验，就会获取到权限范围内的独立成员（当权限范围包含了某成员，但不包含成员所在部门，则该成员视为权限范围内的独立成员）。所以开发者在使用该接口时，应该结合通讯录的权限以及要获取的数据，来决定如何使用，要不要带部门 ID。
7.部门接口相关问题
1）如何获取父部门下所有员工的通讯录信息？
目前不能通过一个接口来获取父部门下所有员工的通讯录信息，需要通过获取部门信息列表接口获取父部门下所有部门的department_id，然后通过获取用户列表接口获取每个部门下员工的通讯录信息。
2）为什么获取获取部门信息接口获取到 department_id 有时候返回的带 od-，有时候不带？
确认请求是否指定了不同的 department_id_type ，若没指定，默认是open_department_id。
3）如何理解获取 获取部门信息列表 接口？
答：接口语义是获取部门下的子部门信息，由于数据的获取受到通讯录权限范围的检查，如果请求带上了父部门 ID（根部门的部门 ID 为0），首先会检查应用是有该部门 ID 的通讯录权限（如果带上了0，会校验是否有全员权限），如果有，就会返回该部门下部门（根据 fetch_child 为 true 或 false 来决定是否递归）信息；如果请求没有带上父部门 ID,无法进行 ID 的通讯录权限校验，就会根据通讯录权限范围返回数据，如果通讯录范围是全员，就会返回单个根部门 ID 0（开发者可以通过根部门 id 继续请求），否则返回通讯录范围的部门信息。所以开发者在使用该接口时，应该结合通讯录的权限以及要获取的数据，来决定如何使用，要不要带父部门 ID。
8.错误排查
1）使用批量获取信息接口的时候，只返回了部分信息，没有返回全部批量信息。但为什么接口仍会提示任务执行成功， msg 也会返回“success”？
批量接口的返回值是指当前批量任务的执行情况，意味是否执行，而非是否执行成功。只要能开始执行都会记为“执行”。详细的执行情况可以参考查询批量任务执行状态文档。
2）40013 param error 有哪些情况？
可以通过如下步骤排查：
- 检查一下对应员工/部门的状态，有没有离职 /被删除；
- 参数错误，具体错误原因可参考 message 信息和表下面的补充，如有疑问，请联系管理员；
- 手机号已存在，检查手机号是否重复；
- 手机号和邮箱冲突，检查对应的手机号和邮箱有没有分属于两个不同的飞书账号，如果存在就需要修改其中一个手机号/邮箱，或者注销掉其中一个账号；
- 更新时目标部门下是否有同名部门；
- 不能更新子部门作为父部门；
- 自定义文本字段超过默认的100长度限制
3）新增用户返回 email and mobile account conflict 的解决方案？
手机号和邮箱分别注册了两个不同的账号后，手机号和邮箱实际上是对应登录凭证不同的两个账号。在新增用户时同时设置了之前的手机号和邮箱，就会将手机号和邮箱同时作为登录凭证关联到一个账号，但是之前邮箱和手机号分别在飞书注册了是两个不同的凭证，就会报上面的错误。解决方案是新增的时候只设置手机号，再去更新邮箱，这样邮箱只是作为一个“属性”而不是登录凭证，或者引导用户注销掉其中一个账号。
4）新增用户返回 department id xxxxxxxx is not exist 的原因？
原因一般有如下三个：
- 写入的 department id 不存在
- open_department_id 和 department_id 是两个不同的 id，是否使用了 open_department_id
- 应用不在该部门的通讯录权限范围内
二、消息类动作常见问题
1.消息类动作出现错误了怎么办？
如果遇到“消息类动作”出现问题，请点击以下链接，参考【消息与群组 常见问题】相关文档
【消息与群组 常见问题】文档：
https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/guide/faq
2.开发前须知
1）我应该如何使用OpenAPI提供的开放能力？
飞书的OpenAPI开放能力基于Restful接口对外提供服务。
为了方便开发者快速使用，我们总结了一篇文档，参见：如何调用服务端API2）企业自建应用和应用商店应用ISV的区别是什么？
- 企业自建应用是指在同一个租户内可以使用的应用，通常情况下，飞书开放平台推荐使用企业自建应用来满足所需功能。
- 应用商店应用和ISV应用是指注册在应用商店中多个租户都可以使用的应用。创建应用商店应用需要单独进行申请，参见：申请成为飞书ISV
- 在不同的租户中，appID和clientID相同，但是有不同的tenantKey用于获取tenantToken。不同租户中的botID不同，appID 和tenantKey可以确认一个唯一的botID。
关于自建应用和商店应用更加详细的描述可参见： 自建应用与商店应用3）在将代码上到生产环境之前，我应该如何方便的进行调试？
飞书的OpenAPI开放能力基于Restful接口对外提供服务，为了方便开发者快速体验和测试各类接口，我们提供了Postman的接口模版，在 Postman模版使用说明 中描述了如何利用Postman工具来调试飞书的OpenAPI接口。
如果在使用postman进行接口调试后没有问题，就说明调用接口的参数是正确的。
3.ID类问题
1）app_id和app_secret我应该在哪里获取？
- 打开飞书开放平台主页，点击我的后台-开发者后台，选择自己的机器人应用
- 在左侧导航栏中点击「凭证与基础信息」，即可以看到
2）我应该如何获取群组ID（chat_id）?
想要获取chat_id，可以通过一些OpenAPI的接口，我们有以下接口能够获取chat_id：
具体使用场景和步骤可以参照 群ID 说明。
注意：搜索对用户或机器人可见的群列表接口不支持单聊，只支持群聊
4.机器人相关问题
1）为什么我的机器人在飞书中搜不到？
在申请机器人后，需要做以下两步才可以搜到：
开启机器人能力
打开飞书开放平台主页，点击 我的后台-开发者后台，选择自己的机器人应用，在左侧导航栏的应用功能-机器人标签页中，点击启用机器人能力
将应用发布上线，在应用发布上线成功就可以搜到了。
注意：请确认你选择了正确的机器人应用，以及正确的环境（BOE/Online/海外）
2）提示机器人对某个用户不可见（the bot is invisible to the user），应该如何配置可见性？
配置机器人对某个用户的可见性，是在应用后台对应用发布版本时进行配置的。
打开飞书开放平台主页，点击 我的后台-开发者后台，选择自己的机器人应用
在左侧导航栏中，点击版本管理与发布，再点击右上方的创建版本
点击可用性状态的编辑，增加指定用户的可用性。
点击保存，发布，等待审核通过上线完毕后可见性即可生效。
3）webhook自定义机器人是什么？ 我应该怎么通过webhook机器人发消息？
群内自定义机器人与你开发的机器人应用有所不同：
自定义机器人只能用于在群聊中自动发送通知，不能响应用户@机器人的消息，不能获得任何的用户、租户信息。
自定义机器人可以被添加至外部群使用，机器人应用只能在内部群使用。
具体使用自定义机器人的方法请见自定义机器人指南
我们还提供了一系列机器人相关使用场景的教程，参见消息与群组概述 中的开发教程
4）在开发者后台配置了机器人，但是为什么我的机器人没有出现对话框？
请确认你的应用配置了订阅事件网址，并且订阅了“接收消息”事件，才会出现对话框。
5）怎么实现机器人@人（@所有人、@指定人）？
在机器人发送的普通文本消息（text）、富文本消息（post）、消息卡片（interactive）中，可以使用at标签实现@人效果。
具体请求示意如下：
(1) 在普通文本消息中@人、@所有人:
at标签示意
// at 指定用户<at user_id="ou_xxx">Name</at> //取值必须使用ou_xxxxx格式的 open_id 来at指定人// at 所有人<at user_id="all">所有人</at>
请求体中的content 示意：
{ "content": " {\"text\":\"<at user_id=\\\"ou_xxxxxxxx\\\">Tom</at> text content\"}"}
(2) 在富文本消息中@人、@所有人:
at标签示意
// at 指定用户{ "tag": "at", "user_id": "ou_xxxxxxx",//取值必须使用ou_xxxxx格式的 open_id 来at指定人 "user_name": "tom"}// at 所有人{ "tag": "at", "user_id": "all",//取值使用"all"来at所有人 "user_name": "所有人"}
请求体中的content 示意：
{ "zh_cn": { "title": "我是一个标题", "content": [ [ { "tag": "text", "text": "第一行 :" }, { "tag": "at", "user_id": "ou_xxxxxx",//取值必须使用ou_xxxxx格式的 open_id 来at指定人 "user_name": "tom" } ], [ { "tag": "text", "text": "第二行:" }, { "tag": "at", "user_id": "all", "user_name": "所有人"//取值使用"all"来at所有人 } ] ] }}
(3) 在消息卡片中@人、@所有人:
可以使用消息卡片Markdown内容中的at人标签，标签示意：
// at 指定用户 <at id=ou_xxx></at> //使用open_id at指定人 <at id=b6xxxxg8></at> //使用user_id at指定人 <at email=test@email.com></at> //使用邮箱地址 at指定人// at 所有人 <at id=all></at>
请求体中的content 示意：
{ "config": { "wide_screen_mode": true }, "header": { "title": { "tag": "plain_text", "content": "这是卡片标题内容" }, "template": "blue" }, "elements": [ { "tag": "div", "text": { "content": "at所有人<at id=all></at> \nat指定人<at id=ou_xxxxxx></at>", "tag": "lark_md" } } ]}
注意：
- 对于自定义机器人，由于不具有通讯录信息的访问权限，只支持使用
open_id@指定人，或 @所有人，不支持使用user_id、email@指定人。请注意自定义机器人本身不能调用接口获取用户的open_id，或直接通过用户的邮箱、手机号来@人（恶意开发者可能用这种方式扫出群成员的头像、姓名等隐私信息）。自建应用与商店应用则没有此限制。你可以参考此教程，以任意应用身份请求获取用户的open_id。 - 如果群主开启了
“仅群主和群管理员可@所有人”配置，且机器人不是群主或管理员，则无法@所有人。
6）自定义机器人的 webhook地址有 V1、V2 版本，如何兼容？
请参考帮助文档如何在群聊中使用机器人的附录部分“旧版 webhook (自定义机器人) 使用说明”。
同时，我们推荐使用V2版本的自定义机器人。
7）配置使用 webhook 的自定义机器人时，参数text是否有长度要求？
建议 JSON 的长度不超过 30k，序列化后的 pb 不超过 100k，图片最好小于 10MB。
8）同一个 Custom Bot （自定义机器人）能在不同的群组使用吗？
不能。Custom Bot （自定义机器人）仅能在单个群中使用。
5.消息相关问题
1）发消息的大小有限制吗？
建议 JSON 的长度不超过 30k，序列化后的 pb 不超过 100k，图片最好小于 10MB。
2）已经推送出去的消息，能进行更改吗？
目前只有消息卡片类型的消息能进行更改，可以参考文档 交互模块 查看如何更改，其他的消息不支持更改。
3）图片上传接口对图片的限制有哪些？
- 图片上传格式支持：JPEG、PNG、WEBP、GIF、TIFF、BMP、ICO
- 图片输出格式支持：PNG、JPG、HEIC、WEBP、动态WEBP
- 上传图片的分辨率宽*高不超过200M，字节数不超过150MB
- 最大支持上传头像图片尺寸- 4096x4096
4）可以通过接口给外部联系人发送消息吗？
目前不支持
5）发消息时如何“@所有人”？
可参见：发送消息content说明，按照下图中的提示，填入<at user_id="all"></at>即可。
6）发送的消息命中了敏感消息检查规则，可以绕过吗？
首先我们不建议进行敏感消息的绕过，请先检查你发送的消息中是否含有敏感词汇和敏感图片等。如果由于必须原因，可以申请敏感消息白名单，暂时绕过消息审计。 BOT敏感消息拦截反馈
8）发送消息有幂等功能吗？
目前没有这个功能。
9）获取消息中的资源文件接口，可以获取别人发送的消息中的资源文件吗?
可以的，只要这条消息你可以看到即可以拉取对应的资源文件。
6.消息卡片相关问题
1）消息卡片能批量发给多人吗？
支持。API参考批量发送消息。
注意：
- 请求参数中
msg_type为interactive，content取值为card:{}结构体
批量发送的消息卡片不支持更新、不支持回传交互
2）消息卡片是否支持@单个成员？
支持的，语法参看 使用markdown标签3）消息卡片回调超时时间是多少?
卡片回调超时时间为 3s，不支持自定义。如果业务方在 3s 内无法返回可以先返回{}，然后使用在回调中的 token 异步更新卡片。
7.搜索用户所在的群列表可以搜到外部群吗?
搜索对用户或机器人可见的群列表 接口可以搜到外部群，搜索用户所在的群列表（历史版本）不会返回外部群。
推荐使用新版本，历史版本将不再维护。
8.事件相关问题
1）为什么收到消息事件的内容为空？
消息如果被撤回，则事件为空。
2）新老版本事件有什么区别？
新版本使用了新的协议，是老版本的升级版。
两个版本不兼容，老版本不会下线，但是不再迭代，推荐使用新版本。
9.错误排查
1）我在调用某个接口的时候，收到了错误码，错误码对应的错误原因是什么呢？
每一个具体的API接口文档中会有错误码的介绍和排查建议
所有接口的错误码罗列在了服务端错误码说明里，在此文档中搜索也可以。
2）我已经发布了ISV应用的权限，却依旧提示无权限，这是为什么呢？
ISV应用的权限，除了需要发布应用外，还需要在租户管理后台进行授权，才可以生效。3）为什么我申请了权限，但是还是提示我没权限？
申请权限之后，需要进行应用版本发布，发布成功后权限才可以生效。
4）我在调用某个接口的时候触发了频率控制策略，具体的频控策略是怎样的呢？
频控策略是指为了保护后台服务不崩溃，对接口增加一定的调用频率限制的策略。
具体的频控策略可见频控策略 - 服务端文档
5）频控错误码对应的具体触发的频控策略？
| 错误码 | 频控策略 | 建议 |
|---|---|---|
| 230020 | 发送消息（V1）接口触发群维度的发消息限流 | 单群发消息的QPS不超过5QPS，参考 频控策略 |
| 11232 | 发消息接口（V4）触发IM系统维度限流 | 等待后重试。 |
| 11233 | 发消息接口（V4）触发群维度的发消息限流 | 单群发消息的QPS不超过5QPS，参考 频控策略 |
| 11247 | 批量发送消息触发每日额度限制 | 单个应用每天通过该接口发送的总消息条数不超过50万，请合理分配批量发送的额度。 |
| 99991400 | 触发接口频控 | 请求过于频繁，请降低请求频次，调用频率不高于频控策略 |
6）在调用发送消息的API时，提示请求中的消息内容有问题，我应该如何排查解决问题？
在文档发送消息content说明中介绍了富文本消息json转string的规则，这里明确总结如下：
- json整体添加" " 符号括起来
- 要使用 "" 进行转义
- 消息内容中不能带有"\n"换行符，如果要实现换行功能，应增加转义，为"\n"，参考发送消息content说明
参考示例如下：
{"receive_id":"14f76322","msg_type": "post","content":"{\"zh_cn\":{\"title\":\"我是一个标题\",\"content\":[[{\"tag\":\"text\",\"text\":\"第一行:\"},{\"tag\":\"a\",\"href\":\"[http://www.feishu.cn](http://www.feishu.cn/)\",\"text\":\"超链接\"},{\"tag\":\"at\",\"user_id\":\"14f76322\",\"user_name\":\"tom\"}]]}}"}
- 在string中不能含有 unicode
- 建议使用JSON压缩转义工具
如果想发送一些特殊字符，请使用Markdown的方式，使用方法见参见：Markdown模块 - 通用能力 - 开发文档 - 飞书开放平台
10.其他
1）如何区分调用海外和国内的OpenAPI?
调用的是国内还是海外的OpenAPI是通过域名来区分的。
如果想调用海外的OpenAPI，域名为https://open.larksuite.com/。
以发送消息接口为例：
- CN -url: https://open.feishu.cn/open-apis/im/v1/messages
- US -url: https://open.larksuite.com/open-apis/im/v1/messages
2）contentType应该设置为什么呢？我可以随意设置吗？
请注意 contentType 需要设置为"application/json; charset=utf-8"，其他格式不保证支持
三、飞书（自建应用）服务端出现错误码了怎么办？
以下是服务端常用错误码列表，部分未列入的错误码可以在具体 API 接口文档中查询到。你也可以通过右上角搜索功能，全局查找错误码说明和排查建议。表格过大，无法粘贴，请参考下方服务端错误码，排查错误。
服务端错误码
| 错误码 | 说明 | 排查建议 |
|---|---|---|
1002 | Failed | 文档已删除，已删除文件无法获取文档内容 |
1500 | internal error | 内部错误，请稍后重试，仍然出现可以咨询客服 |
1503 | internal error | 内部错误，更新token，但无任何鉴权结果返回，请检查后重试，仍然出现可以咨询客服 |
1551 | internal error | 获取tenant id错误，如有疑问可咨询客服 |
1557 | internal error | 获取open user错误，如有疑问可咨询客服 |
1642 | internal error | 内部错误，更新session失败，请稍后重试，仍然出现可以咨询客服 |
1663 | internal error | 内部错误，请稍后重试，仍然出现可以咨询客服 |
1665 | internal error | 内部错误，请咨询客服 |
1668 | internal error | 内部错误，请稍后重试，仍然出现可以咨询客服 |
2200 | internal error | 内部错误，请稍后重试，仍然出现可以咨询客服 |
4000 | bad request | 传参错误，请确保请求方法、请求信息、请求数据格式等是正确的，如富文本格式是否正确 |
4001 | Invalid token, please refresh | 查看token是否填写正确，是否过期 |
4002 | definition not found | 审批定义找不到，检查审批定义code是否正确 |
4003 | instance not found | 审批实例找不到，检查审批实例ID是否正确 |
4004 | user not found | 用户找不到，检查userId是否正确 |
4005 | method not allowed | HTTP 方法不支持，检查是否是POST 请求 |
4006 | service exception | 服务异常，检查服务可用性 |
5000 | internal error | 内部错误，减少调用频率，稍后再试 |
9499 | bad request 或 invalid param | 请求参数有误，请检查参数的正确性 |
10001 | Your request contains an invalid request parameter | 请求参数无效 |
10002 | Bot can NOT be out of the chat | 机器人不在会话中，请添加机器人后重新请求 |
10003 | invalid parameter | 请求参数缺失或者有误，更多错误信息请参考请求返回的error message |
10004 | user not found | 未找到指定用户 |
10005 | app id unauthorized | 请求鉴权失败，当前请求的应用信息或者租户信息有误 |
10009 | get open_chat_id fail | 获取 open chat id 失败 |
10010 | send message forbidden | 禁止跨企业发送消息 |
10012 | get app access token fail | 获取App Token失败，请参考 API访问凭证概述 |
10013 | get tenant access token fail | 获取Tenant Token失败，请参考 API访问凭证概述 |
10014 | app unauthorized | 应用状态不可用，检查应用是否停用 |
10015 | wrong app secret | App Secret 错误，请在开发者后台确认当前应用的App Secret |
10016 | app resend fail | 重新推送应用 ticket 失败，检查应用是否为ISV应用，自建应用无法调用该接口 |
10017 | Bot is NOT the owner of the resource | 机器人不是资源的所有者，无法获取资源详情 |
10019 | urgent type not support | 未知的加急类型，当前支持应用内加急、短信加急、电话加急三种类型 |
10020 | message id not exist | Message ID 非法 |
10023 | urgent scope unauthorized | 没有对应加急类型的权限，没有对应加急类型的权限。权限的开启需要提交版本发布，通过管理员审核后才能生效，详情参见开启应用权限方法。对开发测试阶段的应用可以使用“测试版应用”功能，申请权限无需发布版本，等待管理员审核，可直接在测试租户完成，详情参见教程。 |
10029 | chat_id not exist | Open Chat ID非法 |
10030 | bot not in chat | 机器人不在会话中，请添加机器人后重新请求 |
10032 | valid user is null | 请求参数中用户列表为空，请检查请求参数 |
10034 | chat tenant id mismatch tenant access token | 租户信息不匹配，不能跨企业发起请求 |
10037 | open_message_id not exist | Open Message ID非法 |
10100 | invalid request | 请求参数错误，检查请求参数是否合法 |
10101 | internal error | 内部错误，请稍后重试，仍然出现可以咨询客服 |
10105 | internal error | 内部错误，获取open user错误，请稍后重试，仍然出现可以咨询客服 |
10200 | crop failed | 图片裁剪失败，请稍后重试，仍然出现可以咨询客服 |
10204 | wrong code | code重复使用了或已过期 |
10400 | bad request | 客户端参数错误，一般不需要排查 |
10500 | internal server error | 服务端异常错误，建议服务端排查 |
11000 | get sso access token fail | 获取SSO Token失败 |
11001 | check security token fail | 校验Security Token 失败 |
11100 | check chat by open chat id fail | Open Chat ID非法 |
11101 | open_id not exist | Open User ID非法 |
11102 | get open_id fail | Open User ID非法 |
11103 | open department id not exist | Open Department ID非法 |
11104 | get open department id fail | Open Department ID非法 |
11105 | user_id not exist | Employee ID非法 |
11106 | get employee_id fail | 获取Employee ID失败 |
11200 | only admin can modify chat name | 更新会话信息失败，不是群主，无法更改群聊信息 |
11201 | bot is not chat owner | 机器人不在会话中，请添加机器人后发起请求 |
11202 | only admin can add chatter | 向会话添加成员失败，机器人不是群主，不能添加成员 |
11203 | send employee ids permission denied | 发送 employee id 信息失败，请确保在应用后台已经设置了获取Employee ID的选项 |
11204 | send department list permission denied | 发送部门列表失败，请确保在应用后台已经设置了获取Department ID的选项 |
11205 | app do not have bot | 应用没有开通机器人能力，请确保在应用后台开通了机器人能力 |
11206 | user not in chat | 用户不在会话中，请添加该用户再发起请求 |
11207 | app is not usage | 应用在当前租户下不可用，请在应用后台检查应用的状态 |
11208 | only group admin can remove chatter | 会话移除成员失败，机器人不是群主，不能移除群组成员 |
11209 | app not exist | 应用不存在 |
11210 | app usage info not exist | 应用在当前租户下未安装，不可使用，联系租户管理员，确认应用安装状态 |
11211 | add chatters is empty | 会话成员信息有误，会话添加成员列表为空 |
11212 | invalid chat_id or user_id | 删除会话成员信息失败，Chat ID或者User ID有误 |
11213 | chat not found | 指定的会话不存在 |
11214 | image not given | 上传图片操作失败，文件列表为空 |
11215 | chat_id is nil | Chat ID非法 |
11216 | get chat id fail | Chat ID非法 |
11217 | this group is set to only admin can add new member | 向会话添加成员失败，当前用户不是群主，不能像群组中添加成员 |
11218 | the number of robots exceeds the limit | 会话中机器人数量已经达到上限，不能继续添加机器人 |
11219 | cross tenant chat forbidden add bot | 跨企业会话无法添加机器人 |
11220 | only admin can disband group | 解散会话失败，当前用户不是群主，不能解散群组 |
11221 | this image does not belong to you | 获取图片数据失败，机器人没有权限获取不属于自身的图片 |
11222 | bot owner not in chat | 应用所有者不在会话中，不能添加机器人到会话 |
11223 | do not have im write permission | 当前操作者没有发送消息的权限，请开通权限后发起请求 |
11224 | message_id invalid | Message ID非法 |
11225 | the bot is invisible to the user | 机器人对用户不可见，不能对其进行操作。可在开发者后台-应用发布-版本管理与发布 编辑应用对用户的可见性并发布。 |
11226 | app_id is nil | App ID非法 |
11227 | image key not exist | Image Key非法 |
11228 | chat is not group | 当前会话不是群组类型 |
11229 | no permission | 请确保在应用后台已经开启了获取用户信息的权限 |
11230 | internal error | 机器人禁止发送当前消息类型的消息 |
11231 | chat not found | 请求的会话不存在 |
11232 | create message service trigger rate limit | 创建消息触发系统超限，请参考 频控策略 |
11233 | create message chat trigger rate limit | 创建消息触发系统超限，请参考 频控策略 |
11234 | this message do not belong you | 非机器人消息，机器人无权获取不属于自己的信息的读取状态信息 |
11235 | this group is set to only admin can mention @All | 当前会话禁止@所有人操作 |
11236 | user is resigned | 用户已经离职 |
11237 | group chat dissolved | 指定会话已经解散，不能添加成员 |
11238 | can not recall too old message | 发送较长时间的消息不能召回 |
11239 | permission denied | 尝试获取其他租户信息，操作失败 |
11240 | Robot not turned on | 机器人没有启用，请确保在应用后台开通了机器人能力 |
11241 | no user_info scope | 应用权限没有开启用户信息选项，请确保在应用后台已经设置了获取用户信息的选项 |
11242 | this chat has been banned | 当前会话已经被封禁，无法对会话内消息进行回复 |
11244 | file key not exist | 文件不存在 |
11245 | this file does not belong to you | 尝试获取不属于自己的文件，操作失败 |
11246 | create message content fail | 创建消息内容失败，更多错误信息请参考请求返回的error message |
11247 | internal send message trigger rate limit | 请求触发频控，请参考 频控策略 |
11248 | message is sensitive | 消息内容涉及敏感信息，发送失败 |
11249 | bot not found | 给定的机器人不存在 |
11251 | chat name too short | 会话名字太短，确保不少于2个字符 |
11252 | chat information review fail | 会话信息审核未通过，确保会话信息不包含敏感信息 |
11310 | get card message fail | 消息卡片请求失败，更多错误信息请参考请求返回的code和message，以及卡片错误码文档 |
11311 | urgent message fail | 加急消息错误，仍然出现可以咨询客服 |
11312 | messages do not pass the audit | 消息内容不合法，请检查消息内容 |
12001 | Your request contains an invalid request parameter. | 请求参数无效 |
12002 | Non-chat-owner can NOT edit chat information in the current situation. | 群主设置"仅群主可编辑群信息"，非群主无法更新群信息 |
12008 | Your request specifies a chat whose type is NOT supported currently | 会话类型不支持 |
12011 | Operator can NOT be out of the chat. | 机器人或授权用户不在群组中，请添加后再发起请求 |
12015 | Your request specifies a member_id_type which is NOT supported. | 不支持member_id_type，仅支持以 open_id/user_id/union_id/app_id 作为查询参数 |
12016 | Non-chat-owner can only edit certain parts | 群主设置"仅群主可编辑群信息"，非群主无法更新群信息 |
12018 | Updating announcement failed | 更新公告失败 ，请查看日志了解具体原因 |
18017 | create urgent message fail | 创建加急消息失败，请确保请求参数正确 |
18033 | upload image fail | 上传图片失败，请确保请求参数正确 |
18034 | get chat id fail | 获取 chat id 失败，请确保请求参数正确 |
18035 | image_key require | 获取图片数据失败，请确保请求参数正确 |
18053 | create message fail | 创建消息失败，请确保请求参数正确 |
18054 | create message content fail | 创建消息内容失败，请仔细检查消息内容是否涉及敏感信息 |
18113 | thread not found | 检查当前话题是否存在 |
18117 | reach limit of chat size | 群人数超过上限 |
18121 | create request is being processed | 相同的创建消息请求正在处理中，请稍后重试。 |
19002 | incorrect input format or can't find msg_type | 参数格式不对或缺少msg_type参数，检查参数格式，并确认传入了msg_type |
19036 | The message exceeds the size limit of 30KB | 参数大小超过限制，检查消息体大小 |
20001 | invalid request | 无效的请求体，请确保请求方法、请求信息、请求数据格式等是正确的 |
20005 | invalid access_token | 无效的 access_token，请确保header里的 access_token 是正确、有效的，详情可参考API访问凭证概述 |
20007 | generate access_token fail | 生成 access_token 失败，请确保 code 没有重复消费或过期消费；小程序 tt.login() 获取的 code 不可用于服务端 API 获取用户信息，反之亦然 |
20009 | tenant app not installed | 应用在当前租户未安装 |
20021 | user resigned | 用户已离职，检查用户状态 |
20022 | user frozen | 用户已冻结，检查用户状态 |
20023 | user not registered | 用户未注册，检查用户状态 |
20024 | code app_id not match | appID不匹配，请确保生成code的appID与请求header里app access token对应的appID保持一致 |
30005 | interface is offline | 接口已下线，请切换到新版本接口 |
40001 | param error | 请求参数非法，请检查请求参数 (注：通讯录V3版本接口出现该错误码时取该含义) |
40001 | market place app is not allowed to update user or department | 应用商店应用不允许修改通讯录，请停止尝试 |
40002 | process root dept error | 不能对顶级部门（根部门）进行操作，请检查是否在请求参数的部门ID中填入0 |
40003 | no department authority | 应用没有对应的部门的通讯录授权，请检查通讯录授权情况；如需要访问相应部门，请联系管理员添加相应部门的通讯录授权 |
40003 | internal error | 内部错误，请稍后重试，仍然出现可以咨询客服 （注：通讯录V3版本接口出现该错误码时取该含义） |
40004 | no dept authority error | 应用没有部门权限，检查该部门是否在通讯录权限范围内 |
40006 | internal error | 内部错误，请稍后重试，仍然出现可以咨询客服 |
40007 | user_id %v is not exist | 提供的用户ID不存在，请检查用户ID来源，是否为当前租户下用户 |
40008 | deptInfo is null error | 部门信息为空。可能系统异常导致部门不存在，请咨询客服 (注：通讯录V3版本接口出现该错误码时取该含义) |
40008 | open_id %v is not exist | 提供的用户open_id不存在，请检查用户open_id来源 |
40009 | page size is more more than 50 | 分页的大小超出50这个最大限制，请检查page_size设置的大小 |
40010 | chat id is invalid error | 部门群ID非法 |
40011 | page size is invalid error | 分页请求的page_size参数非法，请检查page_size设置的大小 |
40012 | page token is invalid error | 分页的page_token非法，请检查参数合法性(注：通讯录V3版本接口出现该错误码时取该含义) |
40012 | no parent dept authority error | 应用没有父部门权限，检查该部门是否在通讯录权限范围内 |
40013 | param error | 参数错误，具体错误原因可参考message信息，如有疑问，请联系管理员 |
40014 | dept name can not be nul error | 部门名不能为空，请检查请求中的部门名设置 （注：通讯录V1、V2版本接口出现该错误码时取该含义） |
40014 | no parent dept authority error | 没有父部门权限，检查该部门是否在通讯录权限范围内 (注：通讯录V3版本接口出现该错误码时取该含义） |
40016 | name can not be null in updateRequest error | 更新接口，需带上name字段 |
40018 | duplicate name error | 部门名字冲突，同一父部门的子部门间名字不能相同 |
40021 | not a same request error | client_token判断非同一个请求。两次操作不是同一个请求，请检查request值是否有改动(注：通讯录V3版本接口出现该错误码时取该含义) |
40021 | forbid update department id | 禁止修改部门自定义ID，部门自定义ID是部门当前的唯一ID，企业有其他应用使用通讯录情况下禁止修改 |
40031 | task_id is not exist | task_id 不存在，请检查task_id 来源 |
40032 | task_id invalid | task_id非法，请检查来源，是否为当前企业上传任务生成的task_id |
40040 | invalid page_token | 分页请求的page_token参数非法，请检查page_token来源 |
40041 | request page_size invalid | 分页请求数量不符合接口要求，请参考接口文档传递正确的参数值 |
40042 | batch request object count error | 批量接口请求数量不符合接口要求，请参考接口文档传递正确的参数值 |
40051 | open_id %v is not valid | 用户的open_id非法，检查用户open_id来源，是否为当前应用下的open_id |
40052 | department id %v is not exist | 部门ID不存在，请检查部门ID来源 |
40053 | role_id is not exist | 角色ID不存在，请检查角色ID来源 |
40054 | user_id or open_id is needed | 没有有效的用户ID，user_id或者open_id至少提供其中之一 |
40101 | mobile is already exist | 手机号已存在，手机号在企业内必须唯一，手机号在该企业创建过用户不允许再创建新用户 |
40102 | email is already exist | 邮箱已存在，邮箱在企业内必须唯一，邮箱在该企业创建过用户不允许再创建新用户 |
40103 | mobile and email cp info not match | 手机号和邮箱的账号信息冲突，用户的联系方式属于两个不同的飞书账号，添加失败。如有疑问可咨询客服 |
40104 | mobile is not valid | 手机号不合法，请检查是否是正确的手机号格式 |
40105 | name can’t be null | 部门、用户等name字段不允许为空 |
40106 | email is not valid | 邮箱格式不正确，请检查邮箱地址的有效性 |
40107 | user count exceed certification tenant limit | 用户数量超过未认证企业的数量限制，不能创建用户，如有疑问可咨询客服 |
40108 | user count exceed bill limit | 用户数量超过当前企业套餐的数量限制，不能创建用户，如有疑问可咨询客服 |
40109 | neither email nor mobile is not provided | 邮箱手机号都未指定，创建用户，手机号邮箱至少指定其一 |
40110 | mobile is required | 创建用户，手机号必填 |
40111 | user_id is already exist | user_id 已存在，user_id是企业内用户的唯一ID，不能重复 |
40112 | user_id %v is not vaild | 创建用户的user_id格式不合法 |
40113 | must assign department for user | 未指定部门，创建用户，必须指定在哪个部门下创建用户 |
40114 | name contains sensitive words | name中包含敏感信息，不允许创建，如有疑问可咨询客服 |
40115 | invalid join_time | 用户入职时间不合法 |
40116 | invalid gender | 性别参数不合法，取值请参考文档接口参数说明 |
40117 | idp_type is required | idp企业创建用户，idp_type字段必填 |
40118 | idp_type is invalid | idp_type类型非法，请填入正确的idp_type |
40119 | support set or update user_id at most once | 用户自定义ID只允许设置或者更新一次。用户的自定义ID，创建时未指定自定义ID允许修改一次；创建时指定了自定义ID不再允许二次修改 |
40120 | custom_attr id is not set | 自定义属性ID未指明，设置用户自定义属性，必须指明设定的属性ID，属性ID可以通过获取企业自定义属性接口查询 |
40121 | custom_attr %v value not set | 自定义属性值未设定。设置自定义属性，需要传入属性value字段 |
40122 | custom_attr id %v is not exist | 自定义属性ID不存在，请确认自定义属性ID来源，自定义属性ID可以通过获取企业自定义属性接口查询 |
40123 | href custom_attr %v text can’t be null | 设置HREF类型自定义属性，text字段为必填字段 |
40124 | href custom_attr %v url can’t be null | 设置HREF类型自定义属性，url字段为必填字段 |
40125 | user position info invalid | 创建用户岗位信息非法。创建用户岗位时，岗位名称、岗位码和部门都不能为空，有岗位leader时，必须同时指定leader的ID信息 |
40126 | position department invalid, should be one of user’s department | 设置用户岗位部门ID不合法，用户的岗位部门ID必须为用户所在的部门之一 |
40127 | position code is not unique | 用户的岗位码不唯一，同一个用户的多个岗位岗位码信息必须唯一 |
40128 | user has one main position at most | 用户主岗数量错误，一个用户至多只能有设置一个主岗 |
40129 | request contains users of different tenant | 请求的用户来自不同企业，检查请求的用户ID来源，是否为同一企业的用户 |
40130 | update user department conflict with position department, should update position department at the same time | 更新用户的部门与用户岗位部门冲突，用户的岗位部门必须与用户的部门一致，更新用户部门需要同时更新相应的岗位部门，否则阻断更新操作 |
40131 | update user position department conflict with user department, should update user department at the same time | 更新用户的岗位部门与用户部门冲突，用户的岗位部门必须与用户的部门一致，用户的新岗位部门也必须是用户的部门之一，否则阻断更新操作 |
40132 | order department invalid | 用户排序的部门ID非法，请求的用户排序信息中的部门ID必须是用户的部门ID之一 |
40133 | idp check with account failed | IDP 账号检查失败 |
40134 | create account failed | 账号创建失败 |
40135 | idp user_id is required | 创建IDP账号，user_id 必填 |
40136 | update user’s email and mobile empty is forbiden | 更新用户信息，不能将用户的手机号和邮箱同时更新为空 |
40137 | can’t update unactive user’s mobile empty | 更新用户信息，不能将未激活用户的手机号更新为空 |
40138 | 接收者非法。用户离职，用户资源接收者必须为当前企业的在职用户 | |
40139 | unable to join multiple departments, please upgrade Organizational Structure Visible info | 用户无法加入多部门，请在企业管理后台升级“组织架构可见范围”规则 |
40140 | can not set leader to oneself | 不能设置用户的直属上级为其本身，请检查用户的直属上级参数值 |
40141 | can not set user position | 当前企业不支持设置用户岗位信息，如有疑问可咨询客服 |
40142 | user department num exceed the limit | 不支持用户同时属于50个以上的部门，请检查 |
40143 | unable to join multiple departments, please enable multiple departments feature | 当前企业不支持用户同时加入多个部门，如有疑问可咨询客服 |
40144 | department user count exceed | 创建或更新的所属部门中至少有一个部门的直属成员数超过限制，请检查请求中部门的人数 |
40151 | custom department id %v is invaild | 创建或者更新部门，自定义部门ID非法 |
40152 | custom department id %v is not unique | 自定义部门ID已存在，同一企业内，自定义部门ID必须唯一 |
40153 | department name should be unique under same department | 部门名称冲突。同一部门下，部门的名称不允许重复 |
40154 | department unit %v is not exist | 部门单元不存在，请检查部门单元ID |
40155 | duplicate department order | 部门排序order重复。同一部门下，部门order不允许重复 |
40156 | department id is required | 请求未指定部门ID |
40157 | forbidden operation to root department 0 | 不允许操作根部门0。根部门是虚拟部门，不能查询部门请求，更新该部门或者删除该部门 |
40158 | support update custom department id at most once | 超过自定义部门ID更新限制，自定义部门ID至多允许更新一次 |
40159 | department has active members, can’t delete | 待删除部门有在职用户时，不允许直接删除部门，请先处理部门成员后再执行删除操作 |
40160 | department has sub department, can’t delete | 待删除部门有子部门时，不允许直接删除部门，请先删除子部门后再删除部门 |
40161 | can’t get root department info | 根部门为虚拟部门，不能查询其详情信息 |
40162 | departments with more than 500 sub departments are not allowed to call recursively | 当部门的子部门数量超过500个时，不支持递归查询该部门的子部门或者递归查询该部门的成员。请自行实现递归查询逻辑 |
40163 | can not create department unit | 当前企业不支持创建部门单元，如有疑问可咨询客服 |
40164 | department child count exceed | 创建或更新的部门，其所属父部门的子部门数量超过限制，请检查该部门的子部门数量 |
40170 | unit repeat, unit_type and unit_name is exist, can’t create | 部门单元重复。同一企业下，同一部门单元类型下name必须唯一 |
40171 | department unit name invalid | 部门单元名称非法，详见接口文档参数描述 |
40172 | department unit type invalid | 部门单元类型非法，详见接口文档参数描述 |
40173 | custom_id is already exist | 部门单元自定义ID已存在。同一企业内，自定义部门单元ID必须唯一 |
40174 | department unit is still using, can’t be deleted | 部门单元正在使用中，例如有其他部门关联到了该部门单元，此时不允许删除部门单元 |
40175 | department attach to more than one department unit | 一个部门最多关联一个部门单元，无法关联多个部门单元 |
40180 | duplicate user_id in request | 批量请求中，user_id有重复。user_id是用户在企业的唯一标示，不允许重复；请检查批量请求参数 |
40181 | add user, leader must not user himself | 创建用户，用户的直属上级不能为用户自己 |
40182 | MSyncUser must user_id must be assigned | 批量同步用户，必须指定用户的user_id |
40183 | leader user_id circular reference | 批量同步用户，leader信息成环；比如同一个请求创建用户A、B，指定A的leader为B，同时指定B的leader为A的场景。请检查请求参数 |
40184 | add department, parent_id must not equal to current department id | 批量创建部门，部门的父部门不能为部门本身 |
40185 | add department, parent_id must be assigned | 创建部门，必须指定父部门 |
40186 | duplicate department id in request | 批量创建部门，请求中部门自定义ID重复，请检查请求参数 |
40187 | batch request, parent department id incompatible | 批量创建部门，部门参数出现冲突 |
40501 | param required | 检查必填的参数 |
40502 | invalid parameter | 请求参数缺失或者有误，更多错误信息请参考请求返回的error message |
41001 | mobile already exist error | 手机号已经在企业中存在。手机号在企业内必须唯一，手机号在该企业创建过用户不允许再创建新用户 |
41002 | email already exist error | 邮箱已经在企业中存在。邮箱在企业内必须唯一，邮箱在该企业创建过用户不允许再创建新用户 |
41003 | user acount conflict error | 用户的联系方式属于两个不同的飞书账号，添加失败。如有疑问可咨询客服 |
41004 | mobile is invalid error | 手机号不合法，请检查是否是正确的手机号格式 |
41005 | email is invalid error | 不是合法邮箱的邮箱地址，请检查邮箱地址的有效性 |
41006 | no user name error | 无效的用户名，请检查是否传入了用户名 |
41007 | exceed uncertain tenant seat limit error | 用户数量超过未认证企业的数量限制，不能创建用户，如有疑问可咨询客服 |
41008 | exceed bill seat limit error | 用户数量超过未认证企业的数量限制，不能创建用户，如有疑问可咨询客服 |
41009 | no email or mobile error | 创建用户，手机号邮箱至少指定其一 |
41010 | no mobile error | 创建用户，手机号必填 |
41011 | userID already exist error | 用户id已存在。user_id是企业内用户的唯一ID，不能重复 |
41012 | user id is invalid error | 用户id非法。user_id1-64字节的之间的字符 |
41013 | exceed userID update limit error | 超出更新userID的次数上限 |
41014 | user name sensitive error | 用户名中包含敏感信息，如有疑问可咨询客服 |
41015 | idp type invalid error | 登录类型无效 |
41016 | department has too may users error | 部门下成员数量过多。部门下直属成员有数量限制，超过限制不允许添加 |
41017 | department not exist | 部门不存在 |
41018 | position info is invalid error | 岗位信息无效 |
41019 | position department is invalid error | 岗位部门无效，查看部门信息 |
41020 | position code has already exist error | 岗位code无效 |
41021 | position multiple main count error | 用户主岗错误，一个用户至多只能有设置一个主岗 |
41022 | user tenant not match error | 用户的企业信息和应用不对应，检查是否使用其他企业的凭证访问当前企业的资源 |
41023 | update department conflict position department error | 用户的岗位部门与用户的部门不一致。用户的岗位部门必须与用户的部门一致，更新用户部门需要同时更新相应的岗位部门，否则阻断更新操作 |
41024 | update position department conflict department error | 用户的岗位部门与用户的部门不一致。用户的岗位部门必须与用户的部门一致，更新用户部门需要同时更新相应的岗位部门，否则阻断更新操作 |
41025 | order department invalid error | 部门order非法，请求的用户排序信息中的部门ID必须是用户的部门ID之一 |
41027 | create account failed error | 创建用户失败，请稍后重试，仍然出现可以咨询客服 |
41028 | user multi department need upgrade visibility error | 使用多部门需要将可见性版本升级，可在企业管理后台-组织架构可见范围中升级，如有疑问可咨询客服 |
41029 | create or update user multi department error | 更新用户多部门失败。可能多部门功能未开启，咨询企业管理员 |
41030 | set leader to oneself error | 不允许设置自己的上级为自己 |
41031 | position feature not enable error | 岗位设置开关未打开。当前企业不支持设置用户岗位信息，如有疑问可咨询客服 |
41032 | user multi department feature not enable error | 允许用户加入多部门开关未打开。当前企业不支持用户同时加入多个部门，如有疑问可咨询客服 |
41033 | user in too many departments error | 用户加入的部门数过多。不支持用户同时属于50个以上的部门，请检查 |
41034 | email prefix already exist error | 电子邮件的前缀已经存在 |
41035 | email prefix is invalid error | 电子邮件的前缀不合法，请检查拼写 |
41036 | avatar key is invalid error | 头像非法，头像的key通过上传接口获取 |
41037 | avatar is sensitive error | 头像的涉及敏感信息，不可用 |
41038 | gender is invalid error | 性别不合法，申请自查 |
41040 | user name is null error | 用户名为空，请检查参数 |
41041 | department id is not assigned error | 用户所属的部门不能为空 |
41042 | join time is invalid error | 用户的加入时间非法，加入时间应该是有效的时间戳 |
41043 | employee id is not valid error | employee id 非法，employee id 长度应该在1-64个字符之间，不应包含\t\n\r |
41044 | custom attr id is not set error | 请求参数的自定字段ID为空 |
41045 | Custom attribute id is not exist error | 自定义属性ID不存在，请确认自定义属性ID来源，自定义属性ID可以通过获取企业自定义属性接口查询 |
41046 | custom attr value is not set error | 自定义属性对应的值为空 |
41047 | custom attribute href text is null error | HREF类型自定义属性， herf text字段为必填字段 |
41048 | custom attr href url is null error | HREF类型自定义属性,url为必填字段 |
41050 | no user authority error | 没有用户权限，检查该用户是否在通讯录权限范围内 |
41051 | user id info not provide error | 请求user id 为空，请检查user id 参数 |
41052 | acceptor id is invalid error | 辞职资源接受人无效。用户离职后，其文件的接收者不合法 |
41053 | userID already exist error | 用户id已存在。user_id是企业内用户的唯一ID，不能重复 |
41055 | employee type can not be null error | 更新接口中，雇员类型不可为空，请检查 |
41056 | no field authority error | 请求中存在无权限的字段，请查看权限范围 |
41057 | need send email but not set mail error | 需要发送邮件，但是没有设置邮箱 |
41058 | need send sms but not set mobile error | 需要发送短信，但是没有设置手机号 |
41059 | invalid employee type error | 用户的雇员类型错误，请填写1-5之间的数字，1 正式员工 2 实习生 3 外包 4 劳务 5 顾问 |
41060 | inactive employee type error | 员工类型未启用。当前企业并无相应的雇员类型，企业的雇员类型咨询管理员 |
42005 | user has exist in group error | 用户已经存在于用户组 |
42006 | user has resigned error | 用户已经离职 |
42008 | invalid tenant id error | 非法的租户ID，请自查租户是否可用 |
43004 | illegal unit error | 非法的单位信息，确保单位信息合法有效 |
43005 | duplicate order error | 重复的排序，同一部门中order必须唯一 |
43007 | dup dept unit custom id error | 租户内 部门单位自定义ID (unit_id) 重复，或部门自定义ID (department_id) 重复 |
43008 | custom dept id invalid error | 部门自定义ID不合法 |
43010 | big dept forbid recursion error | 部门的子部门过多，不支持递归查询 |
43011 | delete has member dept error | 删除有用户的部门出错 |
43013 | dept too many children error | 部门的直接子部门数量不超过1000 |
45500 | internal error | 内部错误，请稍后重试，仍然出现可以咨询客服 |
47009 | duplicate name error | 名字重复，更换用户组名称重试 |
50003 | invalid app_id | 传参错误，请确保app_id是正确、有效的。 |
50006 | invalid request | 请求参数错误，建议检查请求参数是否合法 |
55001 | server internal error | 服务内部错误，减少调用频率，稍后再试 |
60001 | OpenApiErrorCodeParameterError | 请求参数错误，检查请求参数 |
60002 | OpenApiErrorCodeDefinitionNotFound | 审批定义【approval_code】 找不到，检查审批定义code是否正确 |
60003 | OpenApiErrorCodeInstanceNotFound | 审批实例【instance_code】找不到，检查审批实例ID是否正确 |
60004 | OpenApiErrorCodeUserNotFound | 用户找不到，检查userId是否正确 |
60005 | OpenApiErrorCodeDepartmentNotFound | 部门验证失败，检查用户所属部门 |
60006 | OpenApiErrorCodeValidateFormError | 表单验证失败，检查表单权限 |
60007 | OpenApiErrorCodeSubscriptionExist | 订阅已存在，检查已订阅列表 |
60008 | OpenApiErrorCodeSubscriptionNotExist | 订阅不存在，检查是否已订阅，未订阅不可取消 |
60009 | OpenApiErrorCodeNoPermission | 权限不足，检查权限 |
60010 | OpenApiErrorCodeTaskNotFound | 审批任务【task_id】 找不到，确认taskId是否正确 |
60011 | OpenApiErrorCodeStartPremiumVersion | 该审批为付费审批，免费版用户不能发起这个审批，付费审批免费用户不可发起 |
60012 | OpenApiErrorCodeUuidConflict | 审批实例 uuid 冲突，uuid需要保持唯一 |
60013 | OpenApiErrorCodeUnsupportApporval | 不支持的审批定义，免费用户不支持该类型审批 |
60014 | 获取更新锁失败 | 并发更新同一个审批实例冲突。 |
65001 | OpenApiErrorCodeInternalError | 内部错误，建议检查一下参数并重试 |
90201 | WrongRequestJson | 请求体不是一个 json，请确保请求body是合法的json格式 |
90202 | WrongRange | 请求中range格式有误，检查请求中的range是否合规 |
90203 | Fail | 内部错误，请稍后重试，仍然出现可以咨询客服 |
90204 | WrongRequestBody | 请求体有误，请求入参有问题，请仔细检查入参 |
90205 | InvalidUsers | 非法的 user，检查user信息是否正确 |
90206 | EmptySheetId | sheeId 为空，必须要提供sheetid，修正请求入参 |
90207 | EmptySheetTitle | sheet 名称为空，检查sheet名称是否正确 |
90208 | SameSheetIdOrTitle | 请求中有相同的 sheetId 或 title，调整sheetId或者title |
90209 | ExistSheetId | sheetId 已经存在，请提供不重复的sheetId |
90210 | ExistSheetTitle | sheet title 已经存在，请提供不重复的子表title |
90211 | WrongSheetId | 错误的 sheetId，检查sheetId的正确性 |
90212 | WrongRowOrCol | 非法的行列，检查行列信息是否正确 |
90213 | PermissionFail | 没有文件的权限 forbidden，请获取文件权限 |
90214 | SpreadSheetNotFound | SpreadSheet没有找到，请检查spreadsheet token |
90215 | SheetIdNotFound | sheetId 没有找到，请求入参对应的子表不存在，修正请求参数 |
90216 | EmptyValue | 请求参数错误 或 本次请求未导致数据变更，请检查参数 |
90217 | TooManyRequest | 请求太频繁，请降低请求调用频率 |
90218 | LockedCell | 单元格被保护，检查是否有权限编辑该单元格 |
90219 | CellExcess | 单元格数量超过限制，检查单元格数量 |
90221 | TooLargeResponse | 需要返回的数据过大，降低查询量 |
90222 | TooLargeCell | 单元格内容过大，减少单元格内容 |
90223 | ColIdNotFound | ColId没有设置，检查请求体是否设置ColId字段 |
90224 | RowIdNotFound | RowId没有设置，检查请求体是否设置RowId字段 |
90225 | NotLinkSpreadSheet | 未关联ISV |
90226 | ExcessLimit | 超出限制，根据返回的消息调整请求数量 |
90227 | TooLargeRequest | 请求过大，降低请求量 |
90228 | ImportProcessing | 导入中，等待导入完成 |
90229 | WrongURLParam | URL参数错误 |
90235 | Retry later | 服务端繁忙，请稍后重试；如果仍然出现可以咨询客服 |
90242 | Spreadsheet in mix state | 正在加载文档数据，请等待文档数据加载完成后重试 |
90301 | FAILED | 操作失败 |
90302 | PARAM_ERROR | 参数错误 |
90303 | FORBIDDEN | 没有权限 |
90304 | META_DELETED | 文件已删除 |
90305 | META_NOT_EXIST | 文件不存在 |
90306 | REVIEW_NOT_PASS | 评论内容审核不通过 |
90399 | INTERNAL_ERROR | 内部错误，详情请咨询客服 |
91001 | OPEN_CODE_PARAM_ERROR | 参数错误，对照开发者文档，检查请求参数 |
91002 | OPEN_CODE_FORBIDDEN | 没有权限，操作者给其他人加权限前要先有权限 |
91003 | OPEN_CODE_INVALID_OPERATION | 操作异常，可能的原因有文档设置了不允许跨租户分享、协作者达到上限等 |
91004 | OPEN_CODE_USER_NO_SHARE_PERM | 用户没有共享权限，检查用户是否有分享权限 |
91005 | Resource is deleted | 资源已被删除 |
91201 | FAILED | 处理失败，稍后重试 |
91202 | PARAMERR | 参数错误，检查参数是否正确 |
91203 | NOTEXIST | 数据不存在，检查参数是否正确 |
91204 | FORBIDDEN | 检查用户对文档、文件夹的权限 |
91205 | DELETED | 数据已被删除，检查数据是否还存在 |
91206 | OUT_OF_LIMIT | 超过限制 |
91207 | DUPLICATE | 重复记录 |
91208 | REVIEW | 内容审查不通过 |
91401 | PARAMERR | 参数出现错误，检查参数有效性 |
91402 | NOTEXIST | 未找到，检查token是否有效 |
91403 | FORBIDDEN | 没有权限，检查是否有文档读权限 |
91404 | LOGIN_REQUIRED | 需要登录 |
93001 | param err | 入参校验不通过，检查token和id等信息是否正确 |
93002 | out of limit | 请求列表数量超出预设范围，page list控制在500以内 |
93003 | invalid user | 无效用户，检查用户是否存在 |
93004 | not found | node或space没有记录，检查nodeId和spaceId是否正确 |
93006 | internal err | 程序内部错误可以找研发排查具体问题，可直接找wiki研发确认 |
95001 | internal error | 内部错误，请稍后重试 |
95003 | internal error | 内部错误，请稍后重试 |
95005 | internal error | 内部错误，请稍后重试 |
95006 | Failed | 文档未找到，检查token是否有效 |
95007 | Failed | 文档已删除，已删除文件无法获取文档meta信息 |
95008 | FORBIDDEN | 检查用户对文档、文件夹的权限 |
95009 | Failed | 没有权限，检查是否有文档读权限。添加文档权限 |
95010 | internal error | 内部错误，请稍后重试 |
95011 | internal error | 内部错误，请稍后重试 |
95013 | Failed | 挂载文档失败，无效的folderToken或对目录无权限 |
95017 | 具体错误信息 | 读取文档内容失败，检查revison是否正确 |
95018 | 具体错误信息 | 解析文档内容失败，详见具体错误信息 |
95020 | 具体错误信息 | 批量更新文档操作失败，详见具体错误信息 |
95023 | revision too old | 版本号太老，请使用最新版本号 |
95024 | Failed | 参数无效，检查参数有效性 |
95025 | Failed | 解析请求失败，检查请求是否合法json |
95026 | Failed | 无效的batch_update 操作类型，检查batch_update接口request_type |
95050 | 具体错误信息 | 保存文档内容失败，详见具体错误信息 |
95051 | 具体错误信息 | 创建文档失败，详见具体错误信息 |
95053 | this API does not support the Upgraded Docs(docx), please refer to the https://bytedance.feishu.cn/docx/doxcna26SMxtcPDYMJGqfpNgRng using the correct API. | 此 API 不支持新版文档（docx），请参考新版文档 OpenAPI 接入指引使用正确的 API。 |
95201 | InternalError | 内部错误，详情请咨询客服 |
95202 | InternalError | 内部错误，详情请咨询客服 |
95203 | InternalError | 内部错误，请稍后重试，仍然出现可以咨询客服 |
95204 | InternalError | 内部错误，请稍后重试，仍然出现可以咨询客服 |
95205 | InternalError | 内部错误，请稍后重试，仍然出现可以咨询客服 |
95206 | InternalError | 内部错误，请稍后重试，仍然出现可以咨询客服 |
95207 | InternalError | 内部错误，请稍后重试，仍然出现可以咨询客服 |
95208 | InternalError | 内部错误，请稍后重试，仍然出现可以咨询客服 |
95209 | InternalError | 内部错误，请稍后重试，仍然出现可以咨询客服 |
95299 | DefaultCode | 其他错误，详情请咨询客服 |
96001 | OPEN_CODE_INTERNAL_ERROR | 内部错误，先重试并检查请求参数，仍然出现可以咨询客服 |
96002 | concurrency error,please retry | 权限并发编辑失败，重试请求，且不要并发操作同一篇文档的权限 |
96201 | LOCK | 内部错误，勿并发调用接口，请串行调用 |
96202 | RECOVER | 内部错误，详情请咨询客服 |
96401 | FAILED | 失败，详见具体错误信息 |
96402 | TIMEOUT | 超时 |
96403 | PROCESSING | 请求正在处理中 |
100001 | page token invalid | page token 格式非法，请检查token参数 |
100002 | Invalid field selection [illegal field] | fields 中存在非法字段名，检查fields中的字段名称 |
100003 | time format must follow RFC3339 standard | 时间格式未遵循 RFC3339 标准，请检查时间格式 |
100004 | building id invalid | building ID 非法，请检查Building ID参数 |
100005 | room id invalid | room ID 非法，请检查roomID参数 |
105001 | internal error | 内部错误，请稍后重试，仍然出现可以咨询客服 |
105002 | invalid request | 无效请求，检查请求参数 |
121004 | data not exist | 无效的请求体，请确保请求方法、请求信息、请求数据格式等是正确的 |
154000 | bad request | 传参错误，请确保请求方法、请求信息、请求数据格式等是正确的 |
154001 | unauthorized | 请求鉴权失败，请检查auth信息是否正确，应用租户和服务台租户是否一致 |
190002 | invalid parameters in request | 参数无效，请确保参数名称、参数值、必须参数齐全等是正确的 |
190003 | internal service error | 内部错误，请稍后重试，仍然出现可以咨询客服 |
190005 | app rate limited | 应用被限流，稍后再试，适当减小请求频率 |
191001 | invalid calendar_id | calendar_id无效，检查calendar id是否填写正确 |
191002 | no calendar access_role | 没有日历的访问权限。确保有日历的访问权限，检查一下对日历的访问角色 |
193001 | event not found | 日程没有找到，检查event id是否正确，event是否已创建 |
193003 | event is deleted | 日程已经被删除，检查event id是否正确 |
230003 | invalid_page_token | 无效的 page token，需要使用接口返回的 page token。确认page token 信息，需要使用接口返回的 page token |
230016 | the_message_was_sent_too_long | 消息发送时间已超过七天，无法查询。只能查询发送七天以内的消息 |
232002 | only_chat_owner_can_edit | 群主设置"仅群主可编辑群信息"，非群主无法更新群信息 |
232011 | operator_not_in_chat | 机器人或授权用户不在群组中，请添加后再发起请求 |
232014 | operator_has_no_permission | 操作者没有权限。仅群主或机器人是群的创建者且具备 更新应用创建的群信息 权限时，可以移除用户或者机器人 |
232016 | non_owner_can_only_edit_certain_parts | 机器人或授权用户非群主，仅可修改部分信息(avatar, name, description, i18n_names) |
232019 | The request has been rate limited. | 触发群限流，请控制请求速度 |
1000001 | unexpected head in request | 请求头错误，详情请咨询客服 |
1000002 | invalid parameters in request | 参数错误，排查参数是否符合API预期 |
1000003 | internal service error | 服务器错误，详情请咨询客服 |
1000004 | method rate limited | 接口请求过快，超出频率限制，降低请求频率 |
1000005 | app rate limited | 应用被限流，降低请求频率 |
1000007 | app bot_id not found | bot id没有被找到，检查请求应用是否存在 |
1001001 | invalid calendar_id | calendar id无效，检查calendar id是否正确 |
1001002 | no calendar access_role | 没有日历从访问权限，检查相应calendar id是否正确，相应日历是否有权限 |
1001004 | invalid calendar type | 日历类型无效，检查calendar id是否正确 |
1001501 | user not found | 用户不存在，排查是否传递了不正确的open_id |
1001502 | okr data not found | OKR数据不存在，排查是否传递了不正确的okr_id |
1001901 | internal server error | OKR内部错误，详情请咨询客服 |
1001902 | no permission | OKR无权限访问，排查是否传递了token、okr_id |
1001903 | invalid parameters | 请求参数错误，排查OKR接口参数格式是否正确 |
1001999 | system exception | 未知错误，详情请咨询客服 |
1002000 | acl not found | 访问控制不存在，检查acl_id是否正确，是否已正确创建 |
1003001 | event not found | 日程没有找到，检查日程id是否正确 |
1003003 | event is deleted | 日程已经删除，检查日程id是否正确 |
1004000 | attendee not found | 参与人没有找到，检查attendee id是否正确（标识attendee的唯一id） |
1004004 | invalid attendee type | 无效的参与人类型，检查参与人类型是否都是正确的 |
1050001 | TIME_CHECK_NOT_VALID | 时间范围填写错误，填写准确的时间范围，起始时间不得早于半年前，时间选择范围不能超过一个月 |
1050002 | ErrCode_DATABASE_ERR | 服务内部错误，请稍后重试 |
1050004 | Error_Param_Error | 参数填写非法，检查参数是否填写错误或者缺失 |
1050005 | Error_Page_Size_Invalid | 分页请求的page_size参数非法，请检查page_size设置的大小 |
1050006 | Error_Page_Token_Invalid | 非法的 page token，检查page token是否填写错误 |
1050007 | Error_Event_Name_Not_Found | 非法的 event name，检查event name是否填写错误 |
1050008 | Error_Open_Platform_RPC | 请稍后重试 |
1050009 | Error_Lark_ID_Not_Found | 提供的用户ID不存在，请检查用户ID来源，是否为当前租户下用户 |
1050011 | Error_Event_Module_Invalid | 事件模块非法，检查event module是否填写错误 |
1050012 | Error_Event_Module_Not_Match_Event_Name | 提供的事件类型和事件模块不一致，请修改事件类型或者事件模块保证两者一致 |
1050019 | Error_Not_Support_Query | 不支持的查询，检查是否添加了不支持的查询字段 |
1051002 | param validate error | 参数错误。时间范围不能超出限制，具体限制详见文档，并且时间格式要正确。page_size和page_token也要正确填写 |
1061041 | parent node has been deleted | 父节点已经被删除，请确认parent_token的节点是否被删除 |
1069301 | fail | 操作失败，重试，稳定失败建议咨询客服 |
1069302 | param error | 参数错误，检查参数有效性 |
1069303 | forbidden | 没有权限，检查是否有待评论文档的评论权限（普遍文档默认是有阅读权限即有评论权限） |
1069304 | docs had been deleted | 云文档已被删除，检查待评论文档是否已被删除 |
1069305 | docs not exist | 云文档不存在，检查待评论文档是否能正常访问 |
1069306 | content review not pass | 评论内容审核不通过，排查评论内容是否存在不合法内容 |
1069307 | not exist | 不存在，检查待评论文档是否能正常访问、评论可能不存在/被删除 |
1069308 | exceeded limit | 超过数量上限限制，评论数据超过上限限制，详情请咨询客服 |
1069399 | internal error | 内部错误，请重试，稳定失败建议咨询客服 |
1103003 | tenant no idp config | 租户未开启SSO登录，检查SSO相关配置，确认无误后开启租户SSO开关 |
1103008 | idp user not bind idp cp | 当前用户未绑定企业级联合登录凭证，请调用绑定接口绑定企业级联合登录凭证 |
99991201 | resource not find | 请求路径错误(404)，检查路径是否填写正确 |
99991300 | invalid next parameter:%s | callback url中next参数有问题，请检查并携带正确的next参数 |
99991301 | request method doesn’t match | 请求方法的类型与接口设置的不一致，检查接口设置的请求方法(POST/GET/…)与请求时使用的是否一致 |
99991400 | request trigger frequency limit | 请求过于频繁，请降低请求频次 |
99991401 | ip %s is denied by app setting | IP 被白名单限制。请检查应用是否开启了 IP 白名单，如果开启了，仅白名单中的来源请求可以正常调用。 可以通过以下方式获取你的服务器出口 IP ：
获取到正确的服务器出口 IP 后，可以参考这篇文档，修改你应用的 IP 白名单设置。 |
99991501 | auth login invalid code | 无登录code，请重新登录，仍然出现可以咨询客服 |
99991503 | invalid next parameter: invalid host | callback url中next参数有问题，next和callback的host不相同 |
99991543 | login_user invalid | app_id或app_secret不存在，请检查参数 |
99991611 | get session fail | 小程序请求获取session失败，请检查请求是否带了相应的cookie(lobsession) |
99991612 | session invalid | 小程序请求鉴权失败，请求的session无效 |
99991621 | get session fail | 开放平台sso请求获取session失败，请检查请求是否带了相应的cookie(lobsession) |
99991622 | session invalid | 开放平台sso请求鉴权失败，请求的session无效 |
99991631 | get session fail | lark sso请求获取session失败，请检查请求是否带了相应的cookie(lobsession) |
99991632 | session invalid | lark sso请求 session 校验失败 |
99991641 | auth open invalid session | 当前登录态session无效，请重新登录后使用 |
99991642 | auth open invalid session mina | 当前登录态session已过期，请重新登录后使用 |
99991643 | auth open invalid session sso | open id或refresh token无效，请重新登录，仍然出现可以咨询客服 |
99991644 | auth open invalid config | 内部错误，详情请咨询客服 |
99991645 | auth open invalid user | 当前登录态user无效，请重新登录，仍然出现可以咨询客服 |
99991661 | Need a token | 请求需要使用token认证；请检查请求Header中是否填了正确的Authorization，注意token值前不要漏了 "Bearer "。详情可参考API访问凭证概述 |
99991662 | app not in use | 检查该应用是否处于停用状态 |
99991663 | tenant token invalid | tenant_access_token 无效，更新token。详情可参考API访问凭证概述 |
99991663 | tenant access token not support | 当前请求不支持tenant_access_token，请检查后重试。 |
99991664 | invalid app token | app_access_token 非法，详情可参考API访问凭证概述 |
99991665 | invalid tenant code | tenant_access_token 非法，详情可参考API访问凭证概述 |
99991668 | user access token not support | 当前请求不支持user_access_token，请检查后重试 |
99991668 | token invalid | user_access_token无效，更新token。详情可参考API访问凭证概述 |
99991669 | invalid user refresh token | 用户 refresh token 非法 |
99991670 | invalid sso token | SSO Access Token非法 |
99991671 | Invalid token: must start with t-/u- | 当前请求使用的token格式错误，请检查后重试。详情可参考API访问凭证概述 |
99991672 | No permission | 当前请求未申请相关权限。权限的开启需要提交版本发布，通过管理员审核后才能生效，详情参见开启应用权限方法。对开发测试阶段的应用可以使用“测试版应用”功能，申请权限无需发布版本，等待管理员审核，可直接在测试租户完成，详情参见教程。 |
99991673 | unauthorized app | app状态不可用, 请检查当前租户应用安装状态 |
99991674 | user type not support | 当前请求使用的user type无效，请检查后重试 |
99991675 | parse user error | 当前请求使用的user_id格式错误，请检查后重试 |
99991676 | token no permission | token没有对应的权限，请检查token的权限 |
99991677 | token expire | token已过期，请更新token。详情可参考刷新access_token |
99991681 | auth fail | 第三方鉴权返回错误, 请参考message进行排查 |
99991691 | get session fail | 获取 session 失败，请求未带cookie |
99991692 | auth fail | 鉴权失败, 请参考message进行排查 |
99991693 | session not exist | 鉴权失败，当前session不存在 |
99992351 | these open ids not existed: %v | 部分open_id不存在，请检查后重试 |
99992352 | these lark ids not existed: %v | 部分open_id不存在，请检查后重试 |
99992353 | these lark ids not existed: %v | 部分open_id不存在，请检查后重试 |
99992354 | these ids not existed: %v | message中提示的id不存在，请检查后重试 |
99992355 | these lark ids not existed: %v | 当前chat_id不存在，请检查后重试 |
99992356 | these open_chat ids not existed: %v | 当前chat_id不存在，请检查后重试 |
99992357 | these open_department ids not existed: %v | 当前open_department_id不存在，请检查后重试 |
99992358 | these ids not existed: %v | 当前open_department_id不存在，请检查后重试 |
99992359 | these user ids not existed: %v | 当前user_id不存在，请检查后重试 |
99992360 | these ids not existed: %v | 当前user_id不存在，请检查后重试 |
99992361 | open_id cross app | open_id不属于当前app，请检查后重试 |
99992363 | these ids not existed: %v | 当前union_id不存在，请检查后重试 |
99992364 | these ids not existed: %v | 当前union_id不存在，请检查后重试 |
99992364 | user id cross tenant | 不能使用其他租户下的user_id，请检查后重试 |
99992370 | these ids not existed: %v | 当前open_app_version_id不存在，请检查后重试 |
99992375 | these open_room ids not existed: %v | 当前open_room_id不存在，请检查后重试 |
99992376 | these ids not existed: %v | 当前open_room_id不存在，请检查后重试 |
99992378 | these open_room ids not existed: %v | 当前open_app_version_id不存在，请检查后重试 |
99992379 | these ids not existed: %v | 当前open_department_id不存在，请检查后重试 |
99992380 | these ids not existed: %v | 当前open_department_id不存在，请检查后重试 |
99992381 | union_id cross tenant | union_id不属于当前tenant。当你使用union_id时，需要注意union_id是否属于当前tenant，请检查后重试 |
99992402 | 具体错误信息 | 请求参数缺失或者有误，更多错误信息请参考请求返回的error message |
99992500 | these ids not existed: %v | 当前tenant_key不存在，请检查后重试 |
99992501 | these ids not existed: %v | 当前tenant_key不存在，请检查后重试 |
99993201 | method don't support batch | 请确认批量API文档是否包含该API。 |
99993202 | the id of subrequest can't be empty | 请参考文档的示例，补充子请求的id |
99993203 | the id of subrequest is duplicated | 请确认子请求的id是否重复 |
四、飞书（自建应用）使用时出现错误码了怎么办？
飞书（自建应用）调用接口时可能会出现错误码，用户可以参考下方错误码调试接口，排查错误。
错误码
| code | message | 说明 | 排查建议 |
|---|---|---|---|
| 1020001 | System error | 系统错误 | 联系客服处理 |
| 1002002 | Parameter illegal | 参数异常 | 检查参数是否按照要求传入 |
| 1002101 | Update Talent ID Conflict | 重复人才 | 更新人才时存在重复人才，重复人才与传入的人才 ID 不一致，检查调用逻辑 |
| 1002102 | Talent not exist | 人才不存在 | 检查人才 ID 是否正确 |
| 1002103 | Talent not exist | 人才在职 | 人才已入职 |
| 1002104 | Cannot download attachment | 不能下载目标简历 | 检查简历 ID 是否正确 |
| 1002105 | Duplicate talent | 重复人才 | 重复人才，检查调用逻辑 |
| 1002106 | Name of resume source already exists | 简历来源名称已经存在 | 重复来源名称，检查调用逻辑 |
| 1002107 | Type of resume source is invalid | 简历来源类型无效 | 检查简历来源类型 ID |
| 1002108 | Resume source does not exsit | 简历来源不存在 | 检查简历来源 ID |
| 1002201 | Application not exist | 投递不存在 | 检查投递 ID |
| 1002202 | Job process does not exist | 职位流程不存在 | 检查职位 ID 对应现状是否可用 |
| 1002203 | Job process stage does not exist | 职位状态问题 | 检查职位 ID 对应现状是否可用 |
| 1002204 | Application stage not exist | 投递阶段不存在 | 检查投递阶段 ID |
| 1002205 | Transfer stage failed | 转移阶段失败 | 检查当前投递阶段是否可转移、是否可转移至目标投递阶段 |
| 1002206 | Repeat application | 重复投递 | 重复投递，检查调用逻辑 |
| 1002207 | Job does not exist | 职位不存在 | 检查职位 ID |
| 1002208 | Talent does not exist | 人才不存在 | 检查人才 ID |
| 1002209 | Talent has been hired | 人才已经录用 | 检查人才 ID |
| 1002210 | Talent locked by others | 人才已被锁定 | 检查人才 ID |
| 1002211 | Cannot transfer to target stage | 无法转移至目标阶段 | 检查目标投递阶段 ID |
| 1002212 | Application update fail | 投递更新失败 | 检查当前投递阶段是否可转移、是否可转移至目标投递阶段 |
| 1002213 | Task not exist | 导入任务不存在 | 检查导入任务 ID |
| 1002214 | State not exist | 状态枚举错误 | 检查输入的导入状态枚举 |
| 1002215 | Fail reason is too long | 失败原因超过长度限制 | 失败原因勿超过 512 字符 |
| 1002216 | Talent confidential | 人才保密 | 检查人才 ID |
| 1002217 | The resume source does not exist | 投递的简历来源不存在 | 请检查简历来源 id 是否准确 |
| 1002218 | Application fail to add lock | 加锁失败 | 系统里进行手动调整 |
| 1002219 | Import EHR task redirect url overLen | 重定向跳转链接过长 | 检查重定向链接 |
| 1002301 | Location type not exist | 位置类型不存在 | 检查位置类型 |
| 1002302 | Location name both empty | 位置的中/英文名称都为空 | 检查位置名称 |
| 1002303 | Invalid expire time | 请求过期时长无效 | 检查过期时间格式是否正确 |
| 1002304 | Apply upload Token failed | 申请上传 token 失败 | 检查 token |
| 1002402 | Talent has applied the same job post | 同职位推荐过该人才 | 检查人才 ID |
| 1002403 | Talent already hired | 人才已被录用 | 检查人才 ID |
| 1002404 | Invite token invalid | 邀请码已失效 | 检查邀请 token |
| 1002507 | User doesn't exist | 用户不存在 | 传入正确的用户 ID |
| 1002508 | The number of the candidate's applications exceeds the maximum limit of recruitment project | 项目投递数目超过限制 | 该候选人在此项目投递数目超过限制 |
| 1002509 | The job hasn't been posted to this website | 广告未发布到此官网 | 检查职位广告 id 或者官网 id 是否准确 |
| 1002510 | The candidate has already applied for this job | 同一候选人申请相同职位 | 请检查人才 id 或者职位 id 是否准确 |
| 1002601 | Job not exist | 职位不存在 | 检查职位 ID |
| 1002701 | Recruitment request sync not enable | 未开启同步招聘需求开关 | 开启招聘需求同步开关 |
| 1002702 | Duplicated recruitment request number | 重复招聘需求编号 | 检查招聘需求编号 |
| 1002703 | Recruitment request not exist | 招聘需求不存在 | 检查招聘需求 ID |
| 1002704 | Recruitment request unable to delete | 当前招聘需求不可删除 | 招聘需求关联职位已有申请 Offer、已入职的候选人 |
| 1002801 | Interview not exist | 面试不存在 | 检查面试 ID |
飞书是字节跳动旗下的企业协同OA系统，飞书有两种接入方式，一个企业自建的飞书机器人进行接入，一个使用集简云在飞书平台的机器人进行接入。两个方式的功能有所不同，本文介绍的是飞书企业自建机器人的接入方式。
