openapi: 3.0.0
info:
  description: |
  version: "0.0.1"
  title: Swagger Petstore
tags:
  - name: user
    description: User operations
  - name: auth
    description: Authentication operations
  - name: post
    description: Posts operations
  - name: tag
    description: Tag operations
  - name: category
    description: Category operations
  - name: comment
    description: Comment operations

paths:
  '/auth/register':
    post:
      tags:
        - auth
      summary: User registration
      operationId: register
      responses:
        '200':
          description: Successful registration
        '409':
          description: User with same mail or username exist
  '/auth/login':
    post:
      tags:
        - auth
      summary: Login user to system
      operationId: login
      responses:
        '200':
          description: Successful login
        '401':
          description: Email and password does not match
        '404':
          description: User does not exist
  '/auth/logout':
    post:
      tags:
        - auth
      summary: Logout user to system
      operationId: logout
      responses:
        '200':
          description: Successful logout
        '400':
          description: No one is logged in
  '/auth/resendVerification/{email}':
    get:
      tags:
        - auth
      summary: Resend verification mail
      operationId: resend
      responses:
        '200':
          description: Mail succesfully send
        '404':
          description: User does not exist
        '409':
          description: User already verified
  '/auth/verify/{link}':
    post:
      tags:
        - auth
      summary: Verification user mail
      operationId: verify
      responses:
        '200':
          description: Mail succesfully verified
        '404':
          description: Verification link does not exist
  '/auth/requestPasswordChange':
    post:
      tags:
        - auth
      summary: Request password change
      operationId: requestPassChange
      responses:
        '200':
          description: Succesful request
        '401':
          description: User is not logged in
  '/auth/resetPass':
    post:
      tags:
        - auth
      summary: Change password
      operationId: resetPassword
      responses:
        '200':
          description: Succesful password change
        '401':
          description: User is not logged in