swagger-ui
У меня есть RESTful API, который я недавно создал, и я не буду помнить, как использовать его через несколько месяцев. Я решил документировать свой API с помощью Swagger, однако я схожу с ума. Я http://editor.swagger.io/, чтобы создать YAML файл, который потом конвертировать в JSON-файла развязностью можете и...
Я хочу, чтобы некоторые параметры на swagger имели свое собственное значение по умолчанию. Есть ли вообще, чтобы дать значение по умолчанию ? подобный этому Эта заметка должна быть заполнена автоматически "stackoverflow" ...
Итак, я создаю конечную точку пользователя с помощью nodejs, чтобы добавить пользователя в базу данных, а для документации api я использую редактор swagger, и я совершенно новичок в нем. что я хочу сделать, так это Добавить пользователя с логином, паролем, Аватаром, но у этого пользователя есть несколько роле...
Есть ли способ заставить пружинный ботинок с Джерси служить статическому содержанию? Я прошел через серию учебных пособий и примеров кода по интеграции Swagger в приложение Spring Boot. Я могу сделать так, чтобы он доставил основную развязность.json, но я не могу заставить Swagger UI работать. Я даже не могу...
В Примере редактора Swagger, http://editor.swagger.io/# / , есть раздел" модели " позже в отрисованном документе после отображения конечных точек. Это только функция этого редактора, чтобы увидеть, как вещи смотрят на вас определить их, или это также возможно для отображения всех моделей в Swagger UI? (был...
Я провел последние несколько дней, пытаясь понять, следует ли мне использовать API blueprint, RAML или swagger. Похоже, что swagger имеет самое большое сообщество, но чем ближе я смотрю, тем больше я чувствую, что ему очень не хватает документации (я был вынужден смотреть на код много раз, чтобы попытаться и...
Я видел в документации swagger ui, что вы можете предоставить параметр urls, который является: Массив объектов определения API ({url:"", name:""}), используемый плагином Topbar. При использовании и включении плагина Topbar параметр url не будет проанализирован. Имена и URL-адреса должны быть уникальными ...
Я хочу добавить описание к свойству объекта, на которое ссылается его определение. Что-то вроде этого: newCreditCard: type: object properties: billingPhone: description: Phone number of the card holder $ref: "#/definitions/PhoneNumber" Но редактор пр...
допустим, у меня есть такой параметр, как limit. Это один привыкает повсюду, и это боль, чтобы изменить его везде, если мне нужно обновить его: parameters: - name: limit in: query description: Limits the number of returned results required: false type: number format: int32 ...
Я использовал интерфейс Swagger для отображения моих веб-сервисов REST и разместил его на сервере. однако эта услуга Swagger может быть доступна только на определенном сервере. Если я хочу работать в автономном режиме, кто-нибудь знает, как я могу создать статический PDF-файл с помощью пользовательского инте...