файл swagger — поля для маркировки обязательны и необязательны

#swagger #swagger-ui

#swagger #swagger-пользовательский интерфейс

Вопрос:

Я создаю файл swagger. У меня есть метод POST, в котором у меня есть несколько обязательных и необязательных параметров в теле.

В определении объекта я перечислил поля, которые являются обязательными, как показано ниже.

   type: object
    required:
      - firstname
      - email
      - city
      - country
  

Но эти поля не отображаются как обязательные в тексте запроса.

Я что-то упускаю? Вот скриншот онлайн-редактора Swagger скриншот

Ответ №1:

Ваше определение верно. Если вы перейдете на вкладку «Модель«, вы увидите обязательные поля, указанные в основной схеме.

Пользовательский интерфейс Swagger указывает обязательные поля схемы в модели, а не примерное значение