openapi: 3.0.0
info:
    title: PriceStatistic API
    version: 1.0.0

tags:
- name: "Statistic"
  description: "Statistical data"

paths:
    /statistic/cheapestTours:
        get:
            tags:
            - "Statistic"
            summary: "Find the cheapest tour by params"
            operationId: "get_cheapest_tour"
            parameters:
            - in: query
              name: "countries[]"
              schema:
                  type: array
                  items:
                      type: integer
              required: true
            - in: query
              name: "departureCity"
              schema:
                  type: integer
              required: true
            - in: query
              name: "nightRange[from]"
              schema:
                  type: integer
              required: true
            - in: query
              name: "nightRange[to]"
              schema:
                  type: integer
              required: true
            - in: query
              name: "checkInDateRange[from]"
              schema:
                  type: string
                  format: "Y-m-d"
              required: true
            - in: query
              name: "checkInDateRange[to]"
              schema:
                  type: string
                  format: "Y-m-d"
              required: true
            - in: query
              name: "touristGroup[adults]"
              schema:
                  type: integer
              required: true
            - in: query
              name: "touristGroup[kids]"
              schema:
                  type: integer
              required: true
            - in: query
              name: "touristGroup[infants]"
              schema:
                  type: integer
              required: true
            - in: query
              name: "hotelCategories[]"
              schema:
                  type: array
                  items:
                      type: integer
            - in: query
              name: "resorts[]"
              schema:
                  type: array
                  items:
                      type: integer
            responses:
                200:
                    description: "Ok"
                    content:
                        application/json:
                            schema:
                                type: object
                                properties:
                                    success:
                                        type: boolean
                                        enum: [ true ]
                                    data:
                                        type: array
                                        items:
                                            $ref: "#/components/schemas/CheapestTour"
                default:
                    $ref: "#/components/responses/error"

components:
    responses:
        error:
            description: "Error"
            content:
                application/json:
                    schema:
                        type: object
                        properties:
                            success:
                                type: boolean
                                enum: [ false ]
                            message:
                                type: string

    schemas:
        CheapestTour:
            type: object
            properties:
                tourIdentity:
                    type: string
                price:
                    type: integer
                publishedAt:
                    type: string
                    format: "Y-m-d H:i:s"
                checkinDate:
                    type: string
                    format: "Y-m-d"
                resortId:
                    type: integer
                    default: null
            required: [ "tourIdentity", "price", "publishedAt", "checkinDate" ]