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

CurrentUser:
  get:
    operationId: getCurrentUser
    summary: 查询当前用户
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
    responses:
      '200':
        description: 当前用户摘要
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/UserResponse'
      '400':
        $ref: '../components/responses.yaml#/InvalidArgument'
      '401':
        $ref: '../components/responses.yaml#/AuthenticationError'
      '403':
        $ref: '../components/responses.yaml#/Forbidden'
      '500':
        $ref: '../components/responses.yaml#/InternalError'

Users:
  get:
    operationId: listUsers
    summary: 分页查询人员
    parameters:
      - $ref: '../components/parameters.yaml#/XRequestId'
      - name: organizationId
        in: query
        schema:
          $ref: '../components/schemas.yaml#/StringId'
      - name: includeDescendants
        in: query
        schema:
          type: boolean
          default: false
      - name: keyword
        in: query
        schema:
          type: string
      - name: status
        in: query
        schema:
          $ref: '../components/schemas.yaml#/EnabledStatus'
      - name: page
        in: query
        schema:
          type: integer
          minimum: 1
          default: 1
      - name: pageSize
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
          default: 20
    responses:
      '200':
        description: 人员分页结果
        content:
          application/json:
            schema:
              $ref: '../components/schemas.yaml#/UserPageResponse'
      '400':
        $ref: '../components/responses.yaml#/InvalidArgument'
      '401':
        $ref: '../components/responses.yaml#/AuthenticationError'
      '403':
        $ref: '../components/responses.yaml#/Forbidden'
      '500':
        $ref: '../components/responses.yaml#/InternalError'