XRequestId:
  name: X-Request-Id
  in: header
  required: false
  description: 客户端生成的UUID；未提供时由后端生成。
  schema:
    type: string
    format: uuid

XDocumentPassword:
  name: X-DMS-Document-Password
  in: header
  required: false
  description: 主案密码锁口令；操作被密码保护且当前用户需要口令时必填（缺失返回DOCUMENT_PASSWORD_REQUIRED，错误返回DOCUMENT_PASSWORD_INVALID）。
  schema:
    type: string
    maxLength: 128

XDmsReauthToken:
  name: X-DMS-Reauth-Token
  in: header
  required: false
  description: 敏感操作二次认证令牌（POST /auth/reauth签发，5分钟有效）；缺失/无效/过期/非本人/authVersion不符返回403 REAUTH_REQUIRED。
  schema:
    type: string

UpdatedFrom:
  name: updatedFrom
  in: query
  required: false
  description: 文档自身updatedAt的闭区间开始边界，必须为UTC Z格式。
  schema:
    $ref: './schemas.yaml#/UtcDateTime'

UpdatedTo:
  name: updatedTo
  in: query
  required: false
  description: 文档自身updatedAt的闭区间结束边界，必须为UTC Z格式，且不得早于updatedFrom。
  schema:
    $ref: './schemas.yaml#/UtcDateTime'