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

一、通讯录动作常见问题

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. 在左侧导航栏中点击「凭证与基础信息」,即可以看到

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

2)我应该如何获取群组ID(chat_id)?

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

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

具体使用场景和步骤可以参照 群ID 说明。

注意:搜索对用户或机器人可见的群列表接口不支持单聊,只支持群聊



4.机器人相关问题

1)为什么我的机器人在飞书中搜不到?

在申请机器人后,需要做以下两步才可以搜到:

       开启机器人能力

打开飞书开放平台主页,点击 我的后台-开发者后台,选择自己的机器人应用,在左侧导航栏的应用功能-机器人标签页中,点击启用机器人能力

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

        

将应用发布上线,在应用发布上线成功就可以搜到了。

注意:请确认你选择了正确的机器人应用,以及正确的环境(BOE/Online/海外)
 

2)提示机器人对某个用户不可见(the bot is invisible to the user),应该如何配置可见性?

配置机器人对某个用户的可见性,是在应用后台对应用发布版本时进行配置的。

             打开飞书开放平台主页,点击 我的后台-开发者后台,选择自己的机器人应用

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

          

  在左侧导航栏中,点击版本管理与发布,再点击右上方的创建版本

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

           

   点击可用性状态的编辑,增加指定用户的可用性。

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

             

点击保存,发布,等待审核通过上线完毕后可见性即可生效。
 

3)webhook自定义机器人是什么? 我应该怎么通过webhook机器人发消息?

群内自定义机器人与你开发的机器人应用有所不同:

自定义机器人只能用于在群聊中自动发送通知,不能响应用户@机器人的消息,不能获得任何的用户、租户信息。

自定义机器人可以被添加至外部群使用,机器人应用只能在内部群使用。

具体使用自定义机器人的方法请见自定义机器人指南

我们还提供了一系列机器人相关使用场景的教程,参见消息与群组概述 中的开发教程
 

4)在开发者后台配置了机器人,但是为什么我的机器人没有出现对话框?

请确认你的应用配置了订阅事件网址,并且订阅了“接收消息”事件,才会出现对话框。
 

5)怎么实现机器人@人(@所有人、@指定人)?

在机器人发送的普通文本消息(text)、富文本消息(post)、消息卡片(interactive)中,可以使用at标签实现@人效果。

具体请求示意如下:
 

(1) 在普通文本消息中@人、@所有人:
 

at标签示意

// at 指定用户Name //取值必须使用ou_xxxxx格式的 open_id 来at指定人// at 所有人所有人

请求体中的content 示意:

{	"content": " {\"text\":\"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 指定用户	 //使用open_id at指定人	 //使用user_id at指定人	 //使用邮箱地址 at指定人// 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_idemail @指定人。请注意自定义机器人本身不能调用接口获取用户的open_id,或直接通过用户的邮箱、手机号来@人(恶意开发者可能用这种方式扫出群成员的头像、姓名等隐私信息)。自建应用与商店应用则没有此限制。你可以参考此教程,以任意应用身份请求获取用户的open_id
  • 如果群主开启了“仅群主和群管理员可@所有人”配置,且机器人不是群主或管理员,则无法@所有人。

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

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说明,按照下图中的提示,填入即可。

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

6)发送的消息命中了敏感消息检查规则,可以绕过吗?

首先我们不建议进行敏感消息的绕过,请先检查你发送的消息中是否含有敏感词汇和敏感图片等。如果由于必须原因,可以申请敏感消息白名单,暂时绕过消息审计。 BOT敏感消息拦截反馈

飞书应用发送敏感消息开启拦截说明
 

8)发送消息有幂等功能吗?

目前没有这个功能。
 

9)获取消息中的资源文件接口,可以获取别人发送的消息中的资源文件吗?

可以的,只要这条消息你可以看到即可以拉取对应的资源文件。
 

6.消息卡片相关问题

1)消息卡片能批量发给多人吗?

支持。API参考批量发送消息。
注意:
 

  • 请求参数中msg_typeinteractivecontent 取值为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 :

  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是否重复

四、飞书(自建应用)使用时出现错误码了怎么办?

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

错误码

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

你可能感兴趣的:(java,开发语言,自动化,无代码,服务器)