外观
模板错误码(184*)
段位:184001 - 184999;当前 14 个;全部 V1 暴露
通用约定(HTTP status /
code=1兜底 / 响应结构)见 README经 V1 模板增删改(
/v1/templates/save/update/delete/sort)、模板字段编织(/v1/templates/addField/updateField/removeField/sortFields)、资源级模板绑定(/v1/resourceTemplateBindings/bind/unbind)暴露。
184001 TEMPLATE_CODE_EXISTS
- HTTP status:200
- 含义:模板编码已存在
- 典型触发条件:
/v1/templates/save或/v1/templates/update提交的模板编码在同租户内已被占用 - 处理建议:更换为唯一的模板编码后重试
- 示例响应:
json
{ "code": 184001, "msg": "模板编码已存在", "data": null }184002 SYSTEM_TEMPLATE_NO_DELETE
- HTTP status:200
- 含义:系统预置模板不允许删除
- 典型触发条件:
/v1/templates/delete删除一个由平台预置的系统模板 - 处理建议:系统预置模板不可删除;如需差异化使用,改为创建自建模板
- 示例响应:
json
{ "code": 184002, "msg": "系统模板不可删除", "data": null }184003 TEMPLATE_BOUND_BY_TYPE
- HTTP status:200
- 含义:模板仍被内容类型绑定,无法删除
- 典型触发条件:
/v1/templates/delete删除一个仍被一个或多个内容类型引用的模板 - 处理建议:先解除相关内容类型对该模板的绑定,再删除
- 示例响应:
json
{ "code": 184003, "msg": "模板已被类型绑定,无法删除", "data": null }184004 TEMPLATE_FIELD_NOT_ACTIVE
- HTTP status:200
- 含义:字段未处于启用状态,无法编入模板
- 典型触发条件:
/v1/templates/addField添加的字段当前为非启用状态 - 处理建议:先将该字段启用,再编入模板
- 示例响应:
json
{ "code": 184004, "msg": "字段未启用,无法添加到模板", "data": null }184005 TEMPLATE_FIELD_ALREADY_EXISTS
- HTTP status:200
- 含义:字段已存在于该模板中
- 典型触发条件:
/v1/templates/addField添加的字段已经编入该模板 - 处理建议:字段不可重复添加;如需调整字段配置或顺序,改用
/v1/templates/updateField/sortFields - 示例响应:
json
{ "code": 184005, "msg": "字段已在模板中", "data": null }184006 TEMPLATE_FIELD_NOT_IN_TEMPLATE
- HTTP status:200
- 含义:该字段不在指定模板中
- 典型触发条件:
/v1/templates/updateField或/v1/templates/removeField操作一个未编入该模板的字段 - 处理建议:核对字段标识;仅可操作已编入该模板的字段
- 示例响应:
json
{ "code": 184006, "msg": "模板中不存在该字段", "data": null }184007 TEMPLATE_NOT_FOUND
- HTTP status:200
- 含义:目标模板不存在
- 典型触发条件:按模板标识解析失败(模板增删改、字段编织、资源绑定等多处复用此码)
- 处理建议:核对模板标识;模板可能已被删除或不在可见范围内
- 示例响应:
json
{ "code": 184007, "msg": "模板不存在", "data": null }184008 TEMPLATE_FIELD_SORT_NOT_FOUND
- HTTP status:200
- 含义:排序请求引用了模板内不存在的字段
- 典型触发条件:
/v1/templates/sortFields提交的排序列表中包含未编入该模板的字段 - 处理建议:排序列表只能包含该模板已编入的字段;先取最新字段集合再排序
- 示例响应:
json
{ "code": 184008, "msg": "排序项对应的模板字段不存在", "data": null }184009 TEMPLATE_FIELD_TARGET_INCOMPATIBLE
- HTTP status:200
- 含义:字段的适用目标与模板的适用目标不相交
- 典型触发条件:
/v1/templates/addField添加的字段适用目标(如文档 / 容器)与模板适用目标没有交集 - 处理建议:仅添加适用目标与模板相容的字段
- 示例响应:
json
{ "code": 184009, "msg": "字段适用目标与模板不相容", "data": null }184010 TEMPLATE_NOT_ACTIVE_FOR_BINDING
- HTTP status:200
- 含义:模板未处于启用状态,无法绑定
- 典型触发条件:
/v1/resourceTemplateBindings/bind绑定一个非启用状态的模板 - 处理建议:先将模板启用,再绑定到资源
- 示例响应:
json
{ "code": 184010, "msg": "模板未启用,无法绑定", "data": null }184011 RESOURCE_TEMPLATE_ALREADY_BOUND
- HTTP status:200
- 含义:该模板已绑定到此资源
- 典型触发条件:
/v1/resourceTemplateBindings/bind对已绑定的模板与资源重复发起绑定 - 处理建议:避免重复绑定;如需变更,先解绑再绑定
- 示例响应:
json
{ "code": 184011, "msg": "模板已绑定到此资源", "data": null }184012 RESOURCE_TEMPLATE_BINDING_NOT_FOUND
- HTTP status:200
- 含义:资源与模板的绑定关系不存在
- 典型触发条件:
/v1/resourceTemplateBindings/unbind解除一个不存在的绑定关系 - 处理建议:核对资源与模板标识;该绑定可能已被解除
- 示例响应:
json
{ "code": 184012, "msg": "资源-模板绑定关系不存在", "data": null }184013 RESOURCE_TEMPLATE_TARGET_MISMATCH
- HTTP status:200
- 含义:模板的适用目标与资源类型不匹配
- 典型触发条件:
/v1/resourceTemplateBindings/bind把适用目标与资源类型不匹配的模板绑定到该资源(如将仅适用文档的模板绑定到容器) - 处理建议:仅将适用目标与资源类型匹配的模板绑定到该资源
- 示例响应:
json
{ "code": 184013, "msg": "模板适用目标与资源类型不匹配", "data": null }184014 RESOURCE_TEMPLATE_FIELD_CONFLICT
- HTTP status:200
- 含义:新模板与该资源已绑定的资源级模板存在字段冲突
- 典型触发条件:
/v1/resourceTemplateBindings/bind绑定的模板字段与该资源已绑定模板的字段冲突 - 处理建议:调整模板字段以消除冲突,或先解除存在冲突的已有绑定,再绑定
- 示例响应:
json
{ "code": 184014, "msg": "模板字段与已有绑定冲突", "data": null }