飞书项目帮助中心

Appearance

Return to top

Open API 错误码

http_code
err_code
err_msg
可能的错误原因 & 排查建议
403
10001
No Permission
  • 没有操作权限
    • 更新评论：当前操作人不是评论创建人
    • 更新或删除视图：没有编辑视图的权限
    • 创建子任务：子任务所在空间和路径空间不匹配
    • 节点完成/状态流转：没有权限完成
    • 获取指定的工作项列表：未在对应空间安装插件
403
10002
Illegal Operation
  • 非法操作
    • 节点完成/状态流转：当前节点/状态不能流转到指定节点/状态
403
10003
No Permission To Edit Project Config
  • 暂未开放
403
10004
Operation Failed
  • 操作失败
    • 该操作会导致流程图节点消失，而流程图至少需存在一个节点
401
10021
Token Not Exist
  • 请求头未传plugin_token
401
10022
Check Token Failed
  • plugin_token校验失败
403
10211
Token Info Is Invalid
  • plugin_token信息不合法
    • 插件token错误，无法解析出具体信息
    • 如果是插件级token，未传X-USER-KEY
401
10301
Check Token Perm Failed
  • plugin_token权限校验未通过
    • 没申请当前操作接口的api权限
    • 申请权限了，但是未发布版本或重新发布版本
    • 发布版本了，但是未安装或更新插件
    • 空间ID不存在
401
10302
Check User Error, User Is Resigned
  • 用户已离职
403
10404
No Project Permission
  • 当前操作用户没有空间访问权限
429
10429
API Request Frequency Limit
  • 接口请求过于频繁，超过同一token请求同一接口 15qps 限制
429
10430
API Request Idempotent Limit
  • 接口请求幂等限制，可排查header中X-IDEM-UUID幂等串是否冲突
400
20001
Param Request Limit
  • 获取空间详情：传入的空间id超过最大20的限制
400
20002
Page Size Limit
  • 查询评论：page_size超过最大200的限制
400
20003
Wrong WorkItemType Param
  • 获取指定的工作项列表：work_item_type_keys未填
400
20004
Search User Limit
  • 获取指定的工作项列表：user_keys超过最大10的限制
400
20005
Missing Param
  • 必填的请求参数未填
400
20006
Invalid Param
  • 请求参数不合法，请检查参数与文档是否匹配
    • 如果是创建子任务，提示 target node with role owner config, not support specify 'assignee'"，表明节点负责人和角色绑定，需通过role_assignee字段指定负责人
400
20007
WorkItem Is Already Aborted
  • 工作项已经被终止
400
20008
WorkItem Is Already Restored
  • 工作项已经被恢复
400
20009
Abort Or Restore WorkItem No Reason
  • 终止/恢复工作项，缺失了原因
400
20010
WorkItemType Is Not Same
  • 创建、更新视图：传入的工作项id列表不是同一种工作项类型
400
20011
Input View Is Not Fix View
  • 删除固定视图：目前只支持删除固定视图，想要删除的视图不是固定视图
400
20012
View Is Not In The Input Project
  • 视图的id所属空间不属于参数中的空间
400
20013
Invalid Time Interval
  • 获取指定的工作项列表：时间相关参数，不是毫秒时间戳(13位数字)
400
20014
Project And WorkItem Not Match
  • 工作项所属空间和传入的空间不匹配
400
20015
Field Mix With '-' And Without '-'
  • 存在相同的字段出现在需要返回列表(Without '-') 和 不需要返回列表(With '-')
400
20016
Node Is Not Arrived, Could Not Be operated
  • 节点未到达，无法进行节点流转
400
20017
Node Is Completed, Could Not Be Completed
  • 节点已经完成，无法再次完成
400
20018
Node ID Not Exist In Workflow
  • 节点不存在当前工作项的节点流配置中
400
20019
Invite Bot Limit 5
  • 拉取群的机器人数量超过5个
400
20020
Bot App_ids Empty
  • 未填拉取群的机器人
400
20021
ChatID Not Belong WorkItem
  • 群id不属于参数中的工作项
400
20022
Forbid Self Relation
  • 暂未开放
400
20023
Query Workitem Relation Limit(15
  • 暂未开放
400
20024
Uploaded File Size Limit 100M
  • 上传文件大小限制100M
400
20025
Field_key/Field_alias Missing
  • 字段的key和对接标识都缺失
400
20026
FlowType Is Error, Please Convert To Status FlowType
  • 查询的工作项是状态流工作项
400
20027
FlowType Is Error, Please Convert To Node FlowType
  • 查询的工作项是节点流工作项
400
20028
Workitem Ids Limit 50
  • 传入的工作项id数量限制50
400
20029
Unsupported Field Type
  • 不支持更新的字段类型(字段key会在msg中返回)
400
20030
CompoundField Is Empty
  • 暂未开放
400
20031
Option Value Invalid
  • 暂未开放
400
20032
DifferentSchedule Set Owner Invalid
  • 差异化排期未指定用户更新排期，或者指定的用户超过一个
400
20033
Update Field Invalid
  • 不能更新该字段
400
20034
Duplicate Tag
  • 暂未开放
400
20035
Duplicate Sub Tag
  • 暂未开放
400
20036
Parent Tag Is Missing
  • 暂未开放
400
20037
Node Is not completed, Could Not Be Rollback
  • 节点未完成，无法回滚
400
20038
Required Field Is Not Set
  • 节点完成/状态流转时，必填字段未填写
400
20039
Plugin Token Must Have User Key, But X-USER-KEY Is Not Set In Request Header
  • 使用的是应用token，请求头中必须带上X-USER-KEY
400
20040
Request Form Is Null
  • 上传附件时，传入的表单是空(content-type未选择multipart/form-data)
400
20041
Field RoleOwner Must Be Set In FieldValuePairs
  • 创建工作项必须传入role_owners字段
400
20042
X-User-Key Is Wrong, Please Check First
  • 未填X-User-Key或者传入的user_key错误
400
20043
View Ids Limit 10
  • 查询视图列表时，最多只能传入10个视图id
400
20044
WorkItem Has Been Disabled
  • 工作项已被禁用，无法查询到元数据
400
20045
Comment And WorkItem Not Match
  • 评论不属于指定的工作项
400
20046
Task ID Not Exist In Workflow
  • 工作流中不存在该子任务
400
20047
Role_Assignee and Assignee Can't Be Set Together
  • 更新或创建子任务，role_assignee和assignee不能同时传入
400
20048
Role_Assignee's Role Is Not Match
  • 更新或创建子任务时，传入的role_assignee里面的role与节点绑定的role不匹配
400
20049
TenantGroupID Is Wrong
  • 仅渠道用户使用，填入的TenantGroupId错误
400
20050
「field_key」Field Option Value Is Wrong
  • 更新或创建工作项时，传入的字段选项值错误
400
20051
FieldLinkedStory Value Is Wrong
  • 填入的field_linked_story字段值错误
400
20052
IssueOperator Value Is Wrong
  • 缺陷的operator角色负责人填写错误，可对比获取工作项详情接口返回值的role_owners字段
400
20053
IssueReporter Value Is Wrong
  • 缺陷的reporter角色负责人填写错误，可对比获取工作项详情接口返回值的role_owners字段
400
20055
Search Result Bigger Than 2000, Please Check Your Search Params
  • 查询结果超过2000个，请重新设置筛选条件
400
20056
Only WorkFlow Mode Can Be Aborted Or Restored
  • 只有工作流模式可以终止和恢复
400
20057
Search ProjectKeys And SimpleNames Limit 10
  • 搜索时，传入的ProjectKeys和SimpleNames的并集不能超过10个
400
20058
SearchUser.Role And SearchUser.FieldKey Can't appear together
  • 搜索时，在SearchUser这个结构中，Role和FieldKey不能同时出现
400
20059
SearchUser.FieldKey Or SearchUser.Role Can't Appear Alone，SearchUser.UserKeys Must Appear
  • 搜索时，在SearchUser这个结构中，UserKeys如果为空，Role或FieldKey不能单独传入
400
20060
WorkItemTypeKey Or RelationWorkItemTypeKey Is Not Match In Field Configuration
  • 工作项类型或关联工作项类型，与关联关系的配置不匹配
400
20061
RelationKey Type Is Not Relation In Configuration
  • 指定关联关系的字段类型，不是关联类型
400
20062
RelationType Error
  • 指定的RelationType不存在，目前只支持0：字段key,1：字段alias
404
30005
WorkItem Not Found
  • 工作项未找到，可能是工作项已删除、查询的工作项id不正确、查询的工作项类型和工作项id不匹配
404
30006
User Not Found
  • header中传入的user_key未找到对应用户
  • 获取用户详情接口中：
    • 未查到指定用户
    • 使用了虚拟token，只能查到插件协作者相关信息
404
30007
Workflow Not Found
  • 工作项中未找到节点流
404
30008
Business Not Found
  • 空间下的业务线未找到
404
30009
Field Not Found
  • 字段未在字段配置中，无法更新或创建
404
30010
Stateflow Not Found
  • 工作项中未找到状态流
404
30011
Node Not Found In Workflow
  • 节点在工作项的节点流配置中未找到
404
30012
State Not Found In Stateflow
  • 状态在工作项的状态流配置中未找到
404
30013
Template Not Found
  • 模板未找到
404
30014
WorkItemTypeKey Not Found
  • work_item_type_key未找到
404
30015
Record Not Found
  • 未找到这条记录
404
30016
Project Not Found
  • 传入的project_key未找到对应空间
404
30017
Role Owners Not Found
  • role_owners字段未设置，或者当前操作导致role_owners消失
404
30018
RelationKey Not Exist In Configuration
  • 关联关系key在配置中不存在

常见FAQ

  • 5xx类错误是内部错误，请寻求运营或者oncall协助排查