document-management/backend/openapi/paths/recycle-bin.yaml

RecycleBinDocuments:
  get:
    operationId: listRecycleBinDocuments
    summary: 分页查询文档回收站
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
      - {name: keyword, in: query, schema: {type: string}}
      - name: documentType
        in: query
        schema: {type: string, enum: [MAIN, SUB_PLAN, ATTACHMENT]}
      - name: categoryId
        in: query
        schema: {$ref: '../components/schemas.yaml#/StringId'}
      - name: deletedFrom
        in: query
        schema: {type: string, format: date-time, pattern: 'Z$'}
      - name: deletedTo
        in: query
        schema: {type: string, format: date-time, pattern: 'Z$'}
      - {name: page, in: query, schema: {type: integer, minimum: 1, default: 1}}
      - name: pageSize
        in: query
        schema: {type: integer, minimum: 1, maximum: 100, default: 20}
      - name: sortField
        in: query
        schema:
          type: string
          enum: [deletedAt, documentName, documentType, updatedAt]
          default: deletedAt
      - name: sortDirection
        in: query
        schema: {type: string, enum: [asc, desc], default: desc}
    responses:
      '200':
        description: 回收站分页结果
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/RecycleBinDocumentPageResponse'
      '400': {$ref: '../components/responses.yaml#/InvalidArgument'}
      '401': {$ref: '../components/responses.yaml#/AuthenticationError'}
      '403': {$ref: '../components/responses.yaml#/Forbidden'}
      '500': {$ref: '../components/responses.yaml#/InternalError'}

RestoreRecycleBinDocument:
  post:
    operationId: restoreRecycleBinDocument
    summary: 恢复单条回收站文档
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
      - name: id
        in: path
        required: true
        schema: {$ref: '../components/schemas.yaml#/StringId'}
    requestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: '../components/schemas.yaml#/RestoreDocumentRequest'
    responses:
      '200':
        description: 文档恢复成功
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/RestoreDocumentResponse'
      '400': {$ref: '../components/responses.yaml#/InvalidArgument'}
      '401': {$ref: '../components/responses.yaml#/AuthenticationError'}
      '403': {$ref: '../components/responses.yaml#/Forbidden'}
      '404': {$ref: '../components/responses.yaml#/NotFound'}
      '409': {$ref: '../components/responses.yaml#/Conflict'}
      '415': {$ref: '../components/responses.yaml#/UnsupportedMedia'}
      '500': {$ref: '../components/responses.yaml#/InternalError'}