ATKONBASE

外观

元数据错误码（182*） ​

段位：182001 - 182999；当前 22 个；全部 V1 暴露

通用约定（HTTP status / code=1 兜底 / 响应结构）见 README

经 V1 元数据值读写（/v1/metadata/values/get / set / getBatch / batchSet）、资源表单 Schema（/v1/documents/getFormSchema / /v1/containers/getFormSchema）、字段定义查询（/v1/fieldDefinitions/get）、以及列表的元数据筛选条件校验（/v1/documents/getPage / /v1/containers/getPage）暴露。字段定义 / 词表的 Console 建模管理校验码不在 V1 暴露范围。

182001 METADATA_VALUE_VALIDATION_FAILED ​

  • HTTP status：200
  • 含义：元数据值写入校验失败
  • 典型触发条件：/v1/metadata/values/set 写入时聚合的字段级校验失败（必填缺失 / 取值不合法 / 类型不匹配）
  • 处理建议：按 msg 中聚合的字段错误逐项修正后重试；可先 getFormSchema 取字段约束
  • 示例响应：
json
{ "code": 182001, "msg": "元数据校验失败", "data": null }

182002 METADATA_REQUIRED_FIELD_NO_CLEAR ​

  • HTTP status：200
  • 含义：必填字段不允许清空
  • 典型触发条件：把必填字段置 null、增量操作后变为空、或显式删除其值
  • 处理建议：必填字段须保留有效值；如需清空请先调整字段定义的必填约束（Console）
  • 示例响应：
json
{ "code": 182002, "msg": "必填字段不允许清空", "data": null }

182003 METADATA_SINGLE_VALUE_NO_INCREMENTAL ​

  • HTTP status：200
  • 含义：单值字段不支持增量操作
  • 典型触发条件：对单值字段使用 $add / $remove 增量操作符
  • 处理建议：单值字段直接整体赋值；$add / $remove 仅用于多值字段
  • 示例响应：
json
{ "code": 182003, "msg": "单值字段不支持增量操作", "data": null }

182004 METADATA_SINGLE_VALUE_NO_ARRAY ​

  • HTTP status：200
  • 含义：单值字段不允许提交数组
  • 典型触发条件：给单值字段提交了数组值
  • 处理建议：单值字段提交标量值；多值才用数组
  • 示例响应：
json
{ "code": 182004, "msg": "单值字段不允许数组值", "data": null }

182005 METADATA_UNSUPPORTED_INCREMENTAL_OPERATOR ​

  • HTTP status：200
  • 含义：不支持的增量操作符
  • 典型触发条件：增量对象里出现了 $add / $remove 以外的键
  • 处理建议：增量操作仅支持 $add / $remove
  • 示例响应：
json
{ "code": 182005, "msg": "不支持的增量操作符", "data": null }

182006 METADATA_INCREMENTAL_OPERAND_NOT_ARRAY ​

  • HTTP status：200
  • 含义：增量操作数必须为数组
  • 典型触发条件：$add / $remove 的操作数不是数组
  • 处理建议：$add / $remove 的值用数组承载，即使只有一个元素
  • 示例响应：
json
{ "code": 182006, "msg": "$add / $remove 操作数必须为数组", "data": null }

182007 METADATA_DATE_FORMAT_INVALID ​

  • HTTP status：200
  • 含义：日期 / 日期时间格式不正确
  • 典型触发条件：日期 / 日期时间字段的值不匹配受支持的格式
  • 处理建议：按字段类型使用受支持的日期 / 日期时间格式提交
  • 示例响应：
json
{ "code": 182007, "msg": "日期格式不正确", "data": null }

182008 DOCUMENT_NOT_FOUND ​

  • HTTP status：200
  • 含义：目标文档不存在
  • 典型触发条件：按 docId 解析资源失败（元数据读写 / 表单 Schema / 文档生命周期等多处复用此码）
  • 处理建议：核对 docId；文档可能已被删除或不在可见范围内
  • 示例响应：
json
{ "code": 182008, "msg": "文档不存在", "data": null }

182009 CONTAINER_NOT_FOUND ​

  • HTTP status：200
  • 含义：目标容器不存在
  • 典型触发条件：按 containerId 解析资源失败（元数据读写 / 表单 Schema / 容器与文档生命周期等多处复用此码）
  • 处理建议：核对 containerId；容器可能已被删除或不在可见范围内
  • 示例响应：
json
{ "code": 182009, "msg": "容器不存在", "data": null }

182010 UNSUPPORTED_RESOURCE_TYPE ​

  • HTTP status：200
  • 含义：资源类型暂不支持
  • 典型触发条件：resourceType 非 DOCUMENT / CONTAINER
  • 处理建议：元数据操作仅支持 DOCUMENT / CONTAINER
  • 示例响应：
json
{ "code": 182010, "msg": "资源类型暂不支持", "data": null }

182011 RESOURCE_TYPE_NOT_ASSOCIATED ​

  • HTTP status：200
  • 含义：资源未关联内容类型
  • 典型触发条件：目标资源未关联内容类型，无法解析字段 schema
  • 处理建议：先为资源指定内容类型，再读写其元数据
  • 示例响应：
json
{ "code": 182011, "msg": "资源未关联内容类型", "data": null }

182012 SENSITIVE_FIELD_OPERATION_FORBIDDEN ​

  • HTTP status：200
  • 含义：无权操作访问受控字段
  • 典型触发条件：写入或清空「访问受控」字段的值，但调用方所代表的用户未获该字段的字段级「写」授权（受控字段在无授权时默认拒绝写入）。读取场景不报此错——无「读」授权时，该字段值在详情 / 列表 / 搜索结果中自动隐藏
  • 处理建议：由管理方为该用户（或其角色 / 部门）在对应资源或其上级容器上授予该字段的写权限后重试；在上级容器授予一次即对其下所有内容生效
  • 示例响应：
json
{ "code": 182012, "msg": "无权操作受控字段: 客户等级", "data": null }

182013 FIELD_DEFINITION_NOT_FOUND ​

  • HTTP status：200
  • 含义：字段定义不存在
  • 典型触发条件：/v1/fieldDefinitions/get 等解析字段定义失败
  • 处理建议：核对字段标识（attributeKey / fieldId）；字段可能未创建、已删除、或标识拼写错误
  • 示例响应：
json
{ "code": 182013, "msg": "字段定义不存在", "data": null }

182014 METADATA_FILTER_TYPE_REQUIRED ​

  • HTTP status：200
  • 含义：使用元数据筛选时必须指定内容类型
  • 典型触发条件：getPage 带元数据筛选条件，但未指定内容类型
  • 处理建议：元数据筛选需限定到具体内容类型（字段集合随类型确定）
  • 示例响应：
json
{ "code": 182014, "msg": "元数据筛选必须指定内容类型", "data": null }

182015 METADATA_FILTER_ATTRIBUTE_KEY_REQUIRED ​

  • HTTP status：200
  • 含义：筛选条件的 attributeKey 不能为空
  • 典型触发条件：筛选条件缺少 attributeKey
  • 处理建议：每个筛选条件须指定要筛选的字段 attributeKey
  • 示例响应：
json
{ "code": 182015, "msg": "筛选字段不能为空", "data": null }

182016 METADATA_FILTER_OPERATOR_REQUIRED ​

  • HTTP status：200
  • 含义：筛选条件的 operator 不能为空
  • 典型触发条件：筛选条件缺少 operator
  • 处理建议：每个筛选条件须指定操作符（如 EQ / IN / RANGE / PREFIX / CONTAINS）
  • 示例响应：
json
{ "code": 182016, "msg": "筛选操作符不能为空", "data": null }

182017 METADATA_FILTER_FIELD_UNSUPPORTED ​

  • HTTP status：200
  • 含义：筛选字段不在该类型的字段集合内
  • 典型触发条件：筛选的 attributeKey 不属于所选内容类型的字段
  • 处理建议：仅按该内容类型已定义的字段筛选
  • 示例响应：
json
{ "code": 182017, "msg": "不支持的筛选字段", "data": null }

182018 METADATA_FILTER_OPERATOR_FIELD_TYPE_UNSUPPORTED ​

  • HTTP status：200
  • 含义：操作符与字段类型不兼容
  • 典型触发条件：操作符与字段类型不匹配（PREFIX / CONTAINS 仅 STRING、RANGE 不支持选项 / 枚举类型、IN 不支持 BOOLEAN）
  • 处理建议：按字段类型选用兼容的操作符
  • 示例响应：
json
{ "code": 182018, "msg": "操作符与字段类型不兼容", "data": null }

182019 METADATA_FILTER_VALUES_REQUIRED ​

  • HTTP status：200
  • 含义：IN 操作符需要提供 values
  • 典型触发条件：使用 IN 但未提供 values 列表
  • 处理建议：IN 操作符须提供非空的 values 列表
  • 示例响应：
json
{ "code": 182019, "msg": "IN 操作符需要 values 列表", "data": null }

182020 METADATA_FILTER_RANGE_BOUND_REQUIRED ​

  • HTTP status：200
  • 含义：RANGE 操作符需要边界
  • 典型触发条件：使用 RANGE 但 rangeFrom 与 rangeTo 均未提供
  • 处理建议：RANGE 至少提供 rangeFrom 或 rangeTo 之一
  • 示例响应：
json
{ "code": 182020, "msg": "RANGE 操作符需要 rangeFrom 或 rangeTo", "data": null }

182021 METADATA_FILTER_VALUE_REQUIRED ​

  • HTTP status：200
  • 含义：筛选值不能为空
  • 典型触发条件：筛选条件缺少筛选值
  • 处理建议：提供非空的筛选值
  • 示例响应：
json
{ "code": 182021, "msg": "筛选值不能为空", "data": null }

182022 METADATA_FILTER_VALUE_TYPE_MISMATCH ​

  • HTTP status：200
  • 含义：筛选值与字段类型不匹配
  • 典型触发条件：筛选值不符合字段类型要求（需整数 / 数值 / 布尔 / 日期 / 日期时间格式）
  • 处理建议：按字段类型提供匹配格式的筛选值
  • 示例响应：
json
{ "code": 182022, "msg": "筛选值与字段类型不匹配", "data": null }