• 【分享】“飞书自建“在集简云平台集成应用的常见问题与解决方案

    一、通讯录动作常见问题

    1.通讯录动作出现错误了怎么办？

    如果遇到“通讯录动作”出现问题，请点击以下链接，参考【通讯录常见问题】相关文档

    【通讯录常见问题】文档：开发文档 - 飞书开放平台

    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.消息类动作出现错误了怎么办？

    如果遇到“消息类动作”出现问题，请点击以下链接，参考【消息与群组 常见问题】相关文档

    【消息与群组 常见问题】文档：

    开发文档 - 飞书开放平台

    2.开发前须知

    1）我应该如何使用OpenAPI提供的开放能力？

    飞书的OpenAPI开放能力基于Restful接口对外提供服务。

    为了方便开发者快速使用，我们总结了一篇文档，参见：如何调用服务端API

    2）企业自建应用和应用商店应用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我应该在哪里获取？

    1. 打开飞书开放平台主页，点击我的后台-开发者后台，选择自己的机器人应用
    2. 在左侧导航栏中点击「凭证与基础信息」，即可以看到

    2）我应该如何获取群组ID（chat_id）?

    想要获取chat_id，可以通过一些OpenAPI的接口，我们有以下接口能够获取chat_id：

    1. 创建群接口
    2. 搜索对用户或机器人可见的群列表接口

    具体使用场景和步骤可以参照 群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">Nameat> //取值必须使用ou_xxxxx格式的 open_id 来at指定人// at 所有人<at user_id="all">所有人at>

    请求体中的content 示意：

    {	"content": " {\"text\":\"\\\"ou_xxxxxxxx\\\">Tom 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所有人 \nat指定人",        "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说明，按照下图中的提示，填入即可。

    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\"}]]}}"}

    如果想发送一些特殊字符，请使用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 ：

    1. 请咨询企业内IT部门的运维人员或云服务提供商；
    2. 登录你的服务器，用命令行执行：curl ifconfig.me 或 curl cip.cc 或 curl myip.ipip.net 或 curl ipinfo.io。

    获取到正确的服务器出口 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是否重复

    四、飞书（自建应用）使用时出现错误码了怎么办？

    飞书（自建应用）调用接口时可能会出现错误码，用户可以参考下方错误码调试接口，排查错误。

    错误码

    codemessage说明排查建议
    1020001System error系统错误联系客服处理
    1002002Parameter illegal参数异常检查参数是否按照要求传入
    1002101Update Talent ID Conflict重复人才更新人才时存在重复人才，重复人才与传入的人才 ID 不一致，检查调用逻辑
    1002102Talent not exist人才不存在检查人才 ID 是否正确
    1002103Talent not exist人才在职人才已入职
    1002104Cannot download attachment不能下载目标简历检查简历 ID 是否正确
    1002105Duplicate talent重复人才重复人才，检查调用逻辑
    1002106Name of resume source already exists简历来源名称已经存在重复来源名称，检查调用逻辑
    1002107Type of resume source is invalid简历来源类型无效检查简历来源类型 ID
    1002108Resume source does not exsit简历来源不存在检查简历来源 ID
    1002201Application not exist投递不存在检查投递 ID
    1002202Job process does not exist职位流程不存在检查职位 ID 对应现状是否可用
    1002203Job process stage does not exist职位状态问题检查职位 ID 对应现状是否可用
    1002204Application stage not exist投递阶段不存在检查投递阶段 ID
    1002205Transfer stage failed转移阶段失败检查当前投递阶段是否可转移、是否可转移至目标投递阶段
    1002206Repeat application重复投递重复投递，检查调用逻辑
    1002207Job does not exist职位不存在检查职位 ID
    1002208Talent does not exist人才不存在检查人才 ID
    1002209Talent has been hired人才已经录用检查人才 ID
    1002210Talent locked by others人才已被锁定检查人才 ID
    1002211Cannot transfer to target stage无法转移至目标阶段检查目标投递阶段 ID
    1002212Application update fail投递更新失败检查当前投递阶段是否可转移、是否可转移至目标投递阶段
    1002213Task not exist导入任务不存在检查导入任务 ID
    1002214State not exist状态枚举错误检查输入的导入状态枚举
    1002215Fail reason is too long失败原因超过长度限制失败原因勿超过 512 字符
    1002216Talent confidential人才保密检查人才 ID
    1002217The resume source does not exist投递的简历来源不存在请检查简历来源 id 是否准确
    1002218Application fail to add lock加锁失败系统里进行手动调整
    1002219Import EHR task redirect url overLen重定向跳转链接过长检查重定向链接
    1002301Location type not exist位置类型不存在检查位置类型
    1002302Location name both empty位置的中/英文名称都为空检查位置名称
    1002303Invalid expire time请求过期时长无效检查过期时间格式是否正确
    1002304Apply upload Token failed申请上传 token 失败检查 token
    1002402Talent has applied the same job post同职位推荐过该人才检查人才 ID
    1002403Talent already hired人才已被录用检查人才 ID
    1002404Invite token invalid邀请码已失效检查邀请 token
    1002507User doesn't exist用户不存在传入正确的用户 ID
    1002508The number of the candidate's applications exceeds the maximum limit of recruitment project项目投递数目超过限制该候选人在此项目投递数目超过限制
    1002509The job hasn't been posted to this website广告未发布到此官网检查职位广告 id 或者官网 id 是否准确
    1002510The candidate has already applied for this job同一候选人申请相同职位请检查人才 id 或者职位 id 是否准确
    1002601Job not exist职位不存在检查职位 ID
    1002701Recruitment request sync not enable未开启同步招聘需求开关开启招聘需求同步开关
    1002702Duplicated recruitment request number重复招聘需求编号检查招聘需求编号
    1002703Recruitment request not exist招聘需求不存在检查招聘需求 ID
    1002704Recruitment request unable to delete当前招聘需求不可删除招聘需求关联职位已有申请 Offer、已入职的候选人
    1002801Interview not exist面试不存在检查面试 ID

  • 相关阅读:
    【mmdetection代码解读 3.x版本】FPN层的解读
    Stable Diffusion 启动时 got an unexpected keyword argument ‘socket_options‘ 错误解决
    LESS vs. SCSS：选择何种CSS预处理器？
    shell编程
    二叉树的层序遍历
    【ACM算法竞赛日常训练】DAY16【奇♂妙拆分】【区区区间间间】【小AA的数列】数学 | 位运算 | 前缀和
    如何使用C++图形界面开发框架Qt创建一个应用程序？（Part 2）
    javascript变量的数据类型 typeof运算符
    C# WinForm —— 07 Form窗体介绍
    使用VMware安装linux虚拟机
  • 原文地址：https://blog.csdn.net/weixin_49220773/article/details/126225981