document-management/backend/openapi/paths/configuration.yaml

UiDictionaries:
  get:
    operationId: getUiDictionaries
    summary: 查询统一UI展示字典
    description: 返回启动时加载的只读展示标签；不提供配置路径或写操作。
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
    responses:
      '200':
        description: 完整UI展示字典
        headers:
          X-Request-Id:
            description: 与响应体requestId相同
            schema:
              type: string
              format: uuid
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/UiDictionariesResponse'
      '401':
        $ref: '../components/responses.yaml#/AuthenticationError'
      '500':
        $ref: '../components/responses.yaml#/InternalError'

LoginBackground:
  get:
    operationId: getLoginBackground
    summary: 查询登录界面自定义背景图
    description: >-
      返回服务端运行目录下的 background.jpg 或 background.png（jpg优先）；
      携带 theme 查询参数（blue/red/green）时优先返回 background-{theme}.jpg/png，
      主题背景图不存在时回落通用 background.jpg/png（契约1.31）；
      运行目录不存在背景图文件时返回404，前端回退默认纯色背景。
      接口公开（登录前无凭证可访问），允许浏览器缓存60秒。
    security: []
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
      - name: theme
        in: query
        required: false
        description: 主题键（契约1.31）；白名单外的取值按未提供处理，回落通用背景图。
        schema:
          type: string
          enum: [blue, red, green]
    responses:
      '200':
        description: 背景图片二进制
        headers:
          X-Request-Id:
            description: 与请求发送的X-Request-Id一致
            schema:
              type: string
              format: uuid
        content:
          image/jpeg:
            schema:
              type: string
              format: binary
          image/png:
            schema:
              type: string
              format: binary
      '404':
        description: 运行目录下不存在背景图文件
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/ErrorResponse'
      '500':
        $ref: '../components/responses.yaml#/InternalError'