swagger.yaml

openapi: 3.0.0
info:
  version: 0.0.1
  title: cookeat
  desdescription: This api for cookeat app.
  termsOfService: 'http://swagger.io/terms/'
  contact:
    email: cookeat@cookeat.com (мыло)
  license:
    name: Apache 2.0
    url: 'http://www.apache.org/licenses/LICENSE-2.0.html'

servers:
  - url: http://185.20.226.71
  - url: http://api.cookeat.com/v1
    description: Main (production) server
  - url: http://cookeat-api.com
    description: Internal staging server for testing

tags:
#  - name: admins
#    description: Secured Admin-only calls
#  - name: developers
#    description: Operations available to regular developers
  - name: recipes
    description: Recipes operations
  - name: utility
    description: Utility operations (categories, ingredients, etc)
  - name: creators
    description: Creators operations (description of us)
  - name: auth
    description: Auth in app operations
  - name: ml
    description: Machine Learning operations
  - name: meal plan
    description: Operations available to control meal plan

paths:
  /recipes :
    description: 'Import recipes'
    get:
      summary: Returns recipes.
      description: 'Get recipes info'
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipesLongListGetResponse'
        '404':
          description: 'Not found'
    post:
      description: 'Import recipes'
      tags:
        - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecipesPostRequest'
      summary: Adds recipes.
      responses:
        '201':
          description: 'Created'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipesIds'
        '400':
          description: 'Bad request'
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  validation_error:
                    $ref: '#/components/schemas/RecipesIdsError'
                required:
                  - validation_error

  /recipes/{recipe_id}:
    parameters:
      - in: path
        name: recipe_id
        required: true
        schema:
          type: integer
    get:
      description: 'Get recipe info'
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeGetResponse'
        '404':
          description: 'Not found'

    patch:
      description: 'Update recipe by id'
      tags:
        - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecipeUpdateRequest'
      responses:
        '200':
          description: 'Created'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeLongItem'
        '400':
          description: 'Bad request'
        '404':
          description: 'Not found'

    delete:
      description: 'Delete recipe info'
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipesIds'
        '404':
          description: 'Not found'

  /recipes/{title}:
    parameters:
      - in: path
        name: title
        required: true
        schema:
          type: string
    get:
      description: 'Get recipe info'
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeGetResponse'
        '404':
          description: 'Not found'

    patch:
      description: 'Update recipe by id'
      tags:
        - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RecipeUpdateRequest'
      responses:
        '200':
          description: 'Created'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipeLongItem'
        '400':
          description: 'Bad request'
        '404':
          description: 'Not found'

    delete:
      description: 'Delete recipe info'
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipesIds'
        '404':
          description: 'Not found'

  /recipes/top:
    description: 'Import recipes'
    get:
      summary: Returns top recipes.
      description: 'Get top recipes info'
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopRecipesGetResponse'
        '404':
          description: 'Not found'
    post:
      description: 'Import top recipes'
      tags:
        - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TopRecipesPostRequest'
      summary: Adds recipes.
      responses:
        '201':
          description: 'Created'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopRecipesIds'
        '400':
          description: 'Bad request'
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  validation_error:
                    $ref: '#/components/schemas/TopRecipesIdsError'
                required:
                  - validation_error
    delete:
      summary: Delete recipe.
      tags:
        - recipes
      responses:
        '200':
          description: 'Deleted'
        '400':
          description: 'Bad request'
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  validation_error:
                    $ref: '#/components/schemas/TopRecipesIdsError'
                required:
                  - validation_error
    patch:
      description: 'Update courier by id'
      tags:
        - recipes
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TopRecipesUpdateRequest'
      responses:
        '200':
          description: 'Created'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopRecipes'
        '400':
          description: 'Bad request'
        '404':
          description: 'Not found'

  /recipes/random:
    get:
      summary: Returns random recipes.
      description: 'Get random recipes info'
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipesShortListGetResponse'
        '404':
          description: 'Not found'

  /recipes/{recipe_id}/similar:
    description: Find recipes which are similar to the given one.
    parameters:
      - in: path
        name: recipe_id
        required: true
        schema:
          type: integer
    get:
      description: 'Get similar recipes info by id '
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecipesShortListGetResponse'
        '404':
          description: 'Not found'

  /recipes/autocomplete:
    description: Autocomplete a partial input to suggest possible recipe names
    get:
      summary: Returns random recipes.
      description: 'Get random recipes info'
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchRecipesGetResponse'
        '404':
          description: 'Not found'

  /recipes/{recipe_id}/tasteWidget:
    description: Get a recipe's taste. The tastes supported are sweet, salty, sour, bitter, savory, and fatty. These tastes are between 0 and 100 while the spiciness value is in scoville on an open scale of 0 and above.
    parameters:
      - in: path
        name: recipe_id
        required: true
        schema:
          type: integer
    get:
      description: "Get recipe's taste info by id "
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TasteGetResponse'
        '404':
          description: 'Not found'

  /recipes/{recipe_id}/equipmentWidget:
    description: Get a recipe's equipment list.
    parameters:
      - in: path
        name: recipe_id
        required: true
        schema:
          type: integer
    get:
      description: "Get recipe's equipment info by id"
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EquipmentGetResponse'
        '404':
          description: 'Not found'

  /recipes/{recipe_id}/ingredientWidget:
    description: Get a recipe's ingredient list.
    parameters:
      - in: path
        name: recipe_id
        required: true
        schema:
          type: integer
    get:
      description: "Get recipe's ingredients info by id "
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IngredientGetResponse'
        '404':
          description: 'Not found'

  /recipes/{recipe_id}/nutritionWidget:
    description: Get a recipe's nutrition widget data.
    parameters:
      - in: path
        name: recipe_id
        required: true
        schema:
          type: integer
    get:
      description: "Get recipe's nutrition info by id "
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NutritionGetResponse'
        '404':
          description: 'Not found'

  /recipes/{recipe_id}/stepsWidget:
    description: (steps) Get an analyzed breakdown of a recipe's instructions. Each step is enriched with the ingredients and equipment required.
    parameters:
      - in: path
        name: recipe_id
        required: true
        schema:
          type: integer
    get:
      description: "Get recipe's cooking instructions info by id "
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StepsGetResponse'
        '404':
          description: 'Not found'

  /recipes/{recipe_id}/summary:
    description: (cделать с фото для того чтобы афигенно вошло в список) Automatically generate a short description that summarizes key information about the recipe.
    parameters:
      - in: path
        name: recipe_id
        required: true
        schema:
          type: integer
    get:
      description: "Get recipe's summary info by id "
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SummaryGetResponse'
        '404':
          description: 'Not found'

  /recipes/{recipe_id}/cuisine:
    description: Classify the recipe's cuisine.
    parameters:
      - in: path
        name: recipe_id
        required: true
        schema:
          type: integer
    get:
      description: "Get recipe's cuisine info by id "
      tags:
        - recipes
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CuisineGetResponse'
        '404':
          description: 'Not found'




  /categories:
    description: 'Import categories'
    get:
      summary: Returns categories.
      description: 'Get categories list'
      tags:
        - utility
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CategoriesListGetResponse'
        '404':
          description: 'Not found'

  /ingredients:
    description: 'Import ingredients'
    get:
      summary: Returns ingredients.
      description: 'Get ingredients list'
      tags:
        - utility
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IngredientsListGetResponse'
        '404':
          description: 'Not found'

  /nutritions:
    description: 'Import nutritions'
    get:
      summary: Returns nutritions.
      description: 'Get nutritions list'
      tags:
        - utility
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NutritionsListGetResponse'
        '404':
          description: 'Not found'

  /cuisines:
    description: 'Import cuisines'
    get:
      summary: Returns cuisines.
      description: 'Get cuisines list'
      tags:
        - utility
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CuisinesListGetResponse'
        '404':
          description: 'Not found'

  /food/ingredients/search:
    description: Search for simple whole foods (e.g. fruits, vegetables, nuts, grains, meat, fish, dairy etc.).

    get:
      summary: Returns recipes.
      tags:
        - utility
      responses:
        '200':
          description: OK
        '400':
          description: Invalid

  /food/ingredients/{id}/substitutes:
    description: Search for substitutes for a given ingredient.

    get:
      summary: Returns recipes.
      tags:
        - utility
      responses:
        '200':
          description: OK
        '400':
          description: Invalid

  /food/products/search:
    description: Search packaged food products, such as frozen pizza or Greek yogurt.
    get:
      summary: Returns recipes.
      tags:
        - utility
      responses:
        '200':
          description: OK
        '400':
          description: Invalid

  /food/products/{id}:
    description: Use a product id to get full information about a product, such as ingredients, nutrition, etc. The nutritional information is per serving.
    get:
      summary: Returns recipes.
      tags:
        - utility
      responses:
        '200':
          description: OK
        '400':
          description: Invalid

  /food/products/upc/{upc}/comparable:
    description: Find comparable products to the given one. здесь штрихкод поменять потом
    get:
      summary: Returns recipes.
      tags:
        - utility
      responses:
        '200':
          description: OK
        '400':
          description: Invalid




  /creators:
    get:
      summary: Returns creators.
      description: 'Get creators list'
      tags:
        - creators
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatorsGetResponse'
        '404':
          description: 'Not found'
    post:
      description: 'Import creators'
      tags:
        - creators
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatorsPostRequest'
      responses:
        '201':
          description: 'Created'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatorsIds'
        '400':
          description: 'Bad request'
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  validation_error:
                    $ref: '#/components/schemas/CreatorsIdsError'
                required:
                  - validation_error

  /creators/{creator_id}:
    parameters:
      - in: path
        name: creator_id
        required: true
        schema:
          type: integer
    get:
      description: 'Get creator info by id'
      tags:
        - creators
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatorGetResponse'
        '404':
          description: 'Not found'

    patch:
      description: 'Update creator by id'
      tags:
        - creators
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatorUpdateRequest'
      responses:
        '200':
          description: 'Created'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatorItem' # переделать
        '400':
          description: 'Bad request'
        '404':
          description: 'Not found'

#    post:
#      description: 'Post creator by id'
#      tags:
#        - creators
#      requestBody:
#        content:
#          application/json:
#            schema:
#              $ref: '#/components/schemas/CreatorPostRequest'
#      responses:
#        '200':
#          description: 'Created'
#          content:
#            application/json:
#              schema:
#                $ref: '#/components/schemas/CreatorItem'
#        '400':
#          description: 'Bad request'
#        '404':
#          description: 'Not found'

    delete:
      description: 'Delete creator info'
      tags:
        - creators
      responses:
        '200':
          description: 'OK'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatorsIds' # переделать
        '404':
          description: 'Not found'



#  остальное с планами на питание и нутришион (meat plan) https://spoonacular.com/food-api/docs#Get-Meal-Plan-Day
  
# отдельно по добавлению всякого к рецепту

#/cuisines
#/categories
#/ingredients
#/nutritions
#/summary - заложить поварешку сюда именно)

components:
  schemas:

    # Get method recipes:
    RecipesLongListGetResponse:
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/RecipeLongItem'
      required:
        - recipes
    
    RecipesShortListGetResponse:
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/RecipeShortItem'
      required:
        - recipes

    RecipeLongItem:
      type: object
      additionalProperties: false
      properties:
        recipe_id:
          type: integer
        name:
          type: string
        date:
          type: string
          format: 'date-time'
        image:
          type: string
          format: binary
        category:
          $ref: '#/components/schemas/CategoryGetResponse'
        cuisine:
          $ref: '#/components/schemas/CuisineGetResponse'
        summary:
          type: array
          items:
            $ref: '#/components/schemas/SummaryGetResponse'
        steps:
          type: array
          items:
            $ref: '#/components/schemas/StepsGetResponse'
        ingredients:
          type: array
          items:
            $ref: '#/components/schemas/IngredientGetResponse'
        nutrition:
          type: array
          items:
            $ref: '#/components/schemas/NutritionGetResponse'
        taste:
          $ref: '#/components/schemas/TasteGetResponse'
        equipment:
          $ref: '#/components/schemas/EquipmentGetResponse'
      required:
        - recipe_id
        - name
        - date
        - image
        - category
        - cuisine
        - summary
        - steps
        - ingredients
        - nutrition
        - taste
        - equipment

    RecipeShortItem:
      description: возможно есть смысл чтобы убрать все доп шемы
      type: object
      additionalProperties: false
      properties:
        recipe_id:
          type: integer
        name:
          type: string
        image:
          type: string
          format: binary
        category:
          $ref: '#/components/schemas/CategoryGetResponse'
        cuisine:
          $ref: '#/components/schemas/CuisineGetResponse'
        summary:
          type: array
          items:
            $ref: '#/components/schemas/SummaryGetResponse'
      required:
        - recipe_id
        - name
        - image
        - category
        - cuisine
        - summary

    RecipeGetResponse:
      # добавить еще одну схему для meal plan  https://spoonacular.com/food-api/docs#Get-Recipe-Information
      type: object
      additionalProperties: false
      properties:
        recipe_id:
          type: integer
        name:
          type: string
        date:
          type: string
          format: 'date-time'
        image:
          type: string
          format: binary
        category:
          $ref: '#/components/schemas/CategoryGetResponse'
        cuisine:
          $ref: '#/components/schemas/CuisineGetResponse'
        summary:
          type: array
          items:
            $ref: '#/components/schemas/SummaryGetResponse'
        steps:
          type: array
          items:
            $ref: '#/components/schemas/StepsGetResponse'
        ingredients:
          type: array
          items:
            $ref: '#/components/schemas/IngredientGetResponse'
        nutrition:
          type: array
          items:
            $ref: '#/components/schemas/NutritionGetResponse'
        taste:
          $ref: '#/components/schemas/TasteGetResponse'
        equipment:
          $ref: '#/components/schemas/EquipmentGetResponse'
      required:
        - recipe_id
        - name
        - date
        - image
        - category
        - cuisine
        - summary
        - steps
        - ingredients
        - nutrition
        - taste
        - equipment

    TopRecipesGetResponse:
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/RecipeShortItem'
      required:
        - recipes
    
    # Post method recipes:
    # RecipesPostRequest:
    #   type: object
    #   additionalProperties: false
    #   properties:
    #     recipes:
    #       type: array
    #       items:
    #         $ref: '#/components/schemas/RecipeItem'
    #   required:
    #     - recipes

    # TopRecipesPostRequest:

    # Patch method recipes:
    # RecipeUpdateRequest:
    # TopRecipesUpdateRequest:




    # Ids responses recipes:
    RecipesIds:
      type: object
      additionalProperties: false
      properties:
        recipes:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              id:
                type: integer
            required:
              - id
      required:
        - recipes

    RecipesIdsError:
      type: object
      additionalProperties: true
      properties:
        recipes:
          type: array
          items:
            type: object
            additionalProperties: true
            properties:
              id:
                type: integer
            required:
              - id
      required:
        - recipes

    TopRecipesIdsError:
      type: object
      additionalProperties: true
      properties:
        recipes:
          type: array
          items:
            type: object
            additionalProperties: true
            properties:
              id:
                type: integer
            required:
              - id
      required:
        - recipes

    TopRecipesIds:
      type: object
      additionalProperties: false
      properties:
        top_recipes:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              id:
                type: integer
            required:
              - id
      required:
        - top_recipes


    # SearchRecipesGetResponse:
    # SearchRecipeItem:
    # SearchIngredientItem:
    # SearchCategoryItem:


    # Utility Get Responses:
    # переделать сие чудо в нормальное состояние в запросе
    CategoriesListGetResponse:
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/CategoryItem'
      required:
        - data

    IngredientsListGetResponse:
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/IngredientItem'
      required:
        - data

    NutritionsListGetResponse:
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/NutritionItem'
      required:
        - data

    CuisinesListGetResponse:
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/CuisineItem'
      required:
        - data

    # Utility Items:
    CategoryItem:
      type: object
      additionalProperties: false
      properties:
        category_id:
          type: integer
        name:
          type: string
        image:
          type: string
          format: binary
        description:
          type: string
      required:
        - ingredient_id
        - name
        - image
        - description
    
    IngredientItem:
      type: object
      additionalProperties: false
      properties:
        ingredient_id:
          type: integer
        name:
          type: string
        image:
          type: string
          format: binary
        nutrition:
          type: array
          items:
            $ref: '#/components/schemas/NutritionGetResponse'
        possible_units:
          type: array
          items:
            type: string
        category_path:
          type: array
          items:
            type: string
        # properties:
        #     weightPerServing:
        #     caloricBreakdown:
        #   пример______________--------
        #       "properties": [
        #       {
        #         "name": "Glycemic Index",
        #         "amount": 58.67,
        #         "unit": ""
        #       },
        #       {
        #         "name": "Glycemic Load",
        #         "amount": 62.23,
        #         "unit": ""
        #       }
        #       ],
        #       "caloricBreakdown": {
        #         "percentProtein": 3.88,
        #         "percentFat": 1.94,
        #         "percentCarbs": 94.18
        #       },
        #       "weightPerServing": {
        #         "amount": 905,
        #         "unit": "g"
        #       }
      required:
        - ingredient_id
        - name
        - image
        - nutrition
        - possible_units
        - category_path
  
    NutritionItem:
      type: object
      additionalProperties: false
      properties:
        nutrition_id:
          type: integer
        name:
          type: string
        influence:
          type: string
          enum:
            - bad
            - neutral
            - good
      required:
        - nutrition_id
        - name
        - influence
  
    CuisineItem:
      type: object
      additionalProperties: false
      properties:
        cuisine_id:
          type: integer
        name:
          type: string
        description:
          type: string
      required:
        - cuisine_id
        - name
        - description
    
    EquipmentItem:
      type: object
      additionalProperties: false
      properties:
        equipment_id:
          type: integer
        name:
          type: string
        image:
          type: string
          format: binary
      required:
        - equipment_id
        - name
        - image

    StepsItem:
      type: object
      additionalProperties: false
      properties:
        step_id:
          type: integer
        name:
          type: string
        text:
          type: string
      required:
        - cuisine_id
        - name
        - text
    
    SummaryItem:
      type: object
      additionalProperties: false
      properties:
        summary_id:
          type: integer
        name:
          type: string
        measure:
          type: string
        quantity:
          type: integer
      required:
        - summary_id
        - name
        - measure
        - quantity


    # single Utility Get responses
    CategoryGetResponse:
      type: object
      additionalProperties: false
      properties:
        category_id:
          type: integer
        name:
          type: string
        image:
          type: string
          format: binary
        description:
          type: string
      required:
        - ingredient_id
        - name
        - image
        - description

    TasteGetResponse:
      type: object
      additionalProperties: false
      properties:
        sweetness:
          type: number
        saltiness:
          type: number
        sourness:
          type: number
        bitterness:
          type: number
        savoriness:
          type: number
        fattiness:
          type: number
        spiciness:
          type: number
      required:
        - sweetness
        - saltiness
        - sourness
        - bitterness
        - savoriness
        - fattiness
        - spiciness

    EquipmentGetResponse:
      type: object
      additionalProperties: false
      properties:
        equipment:
          type: array
          items:
            $ref: '#/components/schemas/EquipmentItem'
      required:
        - equipment
    
    NutritionGetResponse:
      type: object
      additionalProperties: false
      properties:
        nutrition_id:
          type: integer
        name:
          type: string
        percentOfDailyNeeds:
          type: number
        amount:
          type: string
        influence:
          type: string
          enum:
            - bad
            - neutral
            - good
      required:
        - nutrition_id
        - name
        - influence
        - amount
        - percentOfDailyNeeds

    IngredientGetResponse:
      type: object
      additionalProperties: false
      properties:
        ingredient_id:
          type: integer
        name:
          type: string
        image:
          type: string
          format: binary
        nutrition:
          type: array
          items:
            $ref: '#/components/schemas/NutritionGetResponse'
        possible_units:
          type: array
          items:
            type: string
      required:
        - ingredient_id
        - name
        - image
        - nutrition
        - possible_units

    StepsGetResponse:
      type: object
      additionalProperties: false
      properties:
        steps:
          type: array
          items:
            $ref: '#/components/schemas/StepsItem'
        hints:
          type: string
      required:
        - steps
        - hints
    
    SummaryGetResponse:
      type: object
      additionalProperties: false
      properties:
        cooker:
          type: string
          description: поварешка ( хз как сделать наверное enum)
        summary:
          type: array
          items:
            $ref: '#/components/schemas/SummaryItem'
      required:
        - summary

    CuisineGetResponse:
      type: object
      additionalProperties: false
      properties:
        cuisine:
          type: array
          items:
            $ref: '#/components/schemas/CuisineItem'
      required:
        - cuisine

    
    # Creators Schemas:
    CreatorGetResponse:
      type: object
      additionalProperties: false
      properties:
        creator_id:
          type: integer
        name:
          type: string
        image:
          type: string
          description: url view of image
        description:
          type: string
      required:
        - creator_id
        - name
        - photo
        - description
        #- smth else
    
    CreatorUpdateRequest:
      type: object
      additionalProperties: false
      properties:
        name:
          type: string
        photo:
          type: string
          format: binary
        description:
          type: string
      required:
        - name
        - photo
        - description
    
    CreatorItem:
      type: object
      additionalProperties: false
      properties:
        name:
          type: string
        image:
          type: string
          description: url view of image
        description:
          type: string
      required:
        - name
        - photo
        - description
    
    CreatorsIds:
      type: object
      additionalProperties: false
      properties:
        couriers:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              creator_id:
                type: integer
            required:
              - id
      required:
        - creators
    
    CreatorsIdsError:
      type: object
      additionalProperties: true
      properties:
        couriers:
          type: array
          items:
            type: object
            additionalProperties: true
            properties:
              creator_id:
                type: integer
            required:
              - id
      required:
        - creators
    
    CreatorsGetResponse:
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/CreatorItem'
      required:
        - data
    
    CreatorsPostRequest:
      type: object
      additionalProperties: false
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/CreatorItem'
      required:
        - data
#    CreatorPostRequest:
#      тоже самое как и с апдейтом

    # TasteWidgetGetResponse:
    # EquipmentWidgetGetResponse:
    # NutritionWidgetGetResponse:
    # IngredientWidgetGetResponse:
    # StepsGetWidgetResponse:
    # SummaryGetWidgetResponse:
    # CuisineGetWidgetResponse: