swagger-2.0

Я ищу элегантный способ определить api, который может потреблять данные JSON, а также данные формы. Следующий фрагмент работает, но он не элегантен и требует всего вида уродливого кода в бэкэнде. Есть ли лучший способ определить это? Что работает прямо сейчас: paths: /pets: post: consumes: ...

Мои API уважают обычные коды состояния, и я обнаружил, что повторяю тот же текст в части ответов моего определения api 404: description: The resource doesn't exist schema: $ref: '#/definitions/Error' default: description: An unexpected error has occurred ...

В Примере редактора Swagger, http://editor.swagger.io/# / , есть раздел" модели " позже в отрисованном документе после отображения конечных точек. Это только функция этого редактора, чтобы увидеть, как вещи смотрят на вас определить их, или это также возможно для отображения всех моделей в Swagger UI? (был...

У меня есть узел.JS API, в который я хочу добавить документацию swagger. Клиенты авторизуются через JWT, поэтому я добавил Это в безопасность: securityDefinitions: UserSecurity: type: apiKey description: User is logged in in: header name: Authorization Чем я могу добавить это в разные пу...

У меня есть несколько параметров, на которые я хочу ссылаться, но я не хочу указывать их по одному. Этот фрагмент не заставляет параметры отображаться: { ... "paths": { "/stuff": { "get": { "description": "Gets stuff", "operationId": "getStuff", ...

допустим, у меня есть такой параметр, как limit. Это один привыкает повсюду, и это боль, чтобы изменить его везде, если мне нужно обновить его: parameters: - name: limit in: query description: Limits the number of returned results required: false type: number format: int32 ...