document-management/backend/openapi/components/responses.yaml

HealthSuccess:
  description: DMS服务正常
  headers:
    X-Request-Id:
      description: 与响应体requestId相同
      schema:
        type: string
        format: uuid
  content:
    application/json:
      schema:
        $ref: './schemas.yaml#/HealthResponse'

InternalError:
  description: 未处理的服务器错误
  headers:
    X-Request-Id:
      description: 与响应体requestId相同
      schema:
        type: string
        format: uuid
  content:
    application/json:
      schema:
        $ref: './schemas.yaml#/ErrorResponse'

InvalidArgument:
  description: 请求参数错误
  content:
    application/json:
      schema:
        $ref: './schemas.yaml#/ErrorResponse'

AuthenticationError:
  description: 认证失败、Token过期、用户禁用或认证版本失效
  content:
    application/json:
      schema:
        $ref: './schemas.yaml#/ErrorResponse'

Forbidden:
  description: 当前用户无权执行该操作
  content:
    application/json:
      schema:
        $ref: './schemas.yaml#/ErrorResponse'

NotFound:
  description: 分类不存在或已逻辑删除
  content:
    application/json:
      schema:
        $ref: './schemas.yaml#/ErrorResponse'

Conflict:
  description: 数据版本冲突、分类编码重复或分类仍被占用
  content:
    application/json:
      schema:
        $ref: './schemas.yaml#/ErrorResponse'

PayloadTooLarge:
  description: 单文件、批量数量或请求总大小超过限制
  content:
    application/json:
      schema:
        $ref: './schemas.yaml#/ErrorResponse'

UnsupportedMedia:
  description: 文件类型不支持、文件结构损坏或Office不可预览
  content:
    application/json:
      schema:
        $ref: './schemas.yaml#/ErrorResponse'