Вопросы с тегом «swagger»

У меня есть приложение C # ASP.NET WebAPI с документацией API, автоматически создаваемой с помощью Swashbuckle . Я хочу иметь возможность исключить определенные методы из документации, но я не могу понять, как сказать Swagger не включать их в вывод пользовательского интерфейса Swagger. Я чувствую, что это как-то связано с добавлением …

135 c#  asp.net  .net  swagger 

Я пытаюсь передать, что схема аутентификации / безопасности требует установки следующего заголовка: Authorization: Bearer <token> Это то, что я основал на документации по чванству : securityDefinitions: APIKey: type: apiKey name: Authorization in: header security: - APIKey: []

114 swagger  swagger-2.0  swagger-editor 

В моем проекте есть Spring Security. Основная проблема: невозможно получить доступ к URL-адресу swagger по адресу http: // localhost: 8080 / api / v2 / api-docs . Он говорит, что заголовок авторизации отсутствует или недействителен. Снимок экрана окна браузера. В моем pom.xml есть следующие записи <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.4.0</version> </dependency> …

92 spring-mvc  swagger  swagger-ui  swagger-2.0  springfox 

Для некоторых REST API, написанных на PHP, меня попросили создать документацию Swagger , и, поскольку я не знал ни одного простого способа добавления аннотаций к этим существующим API и создания такой документации, я использовал этот редактор для создания некоторых на данный момент. Я сохранил файлы JSON и YAML, созданные с …

88 yaml  swagger  swagger-php 

У меня есть API ReSTFul, написанный на простом Spring (без Spring Boot, без всяких причуд!). Мне нужно внедрить в это Swagger. До сих пор КАЖДАЯ страница в Интернете сводила меня с ума запутанными конфигурациями и раздутым кодом, который я вообще не считал переносимым. Есть ли у кого-нибудь образец проекта (или …

85 spring  spring-mvc  swagger 

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

84 swagger  swagger-2.0  openapi 

Последние два года я работал над Spring Boot Applications с Springfox. Springfox генерирует документацию и тестовый интерфейс для вашего REST API. Это было потрясающе. Но на самом деле проект Springfox мертв и не поддерживает новейшую Spring. У меня три вопроса Есть ли другой способ генерировать Swagger UI напрямую? Любая другая …

11 spring-boot  swagger  swagger-ui  springfox 

Я занимаюсь разработкой веб-API с .Net core 3.0 и хочу интегрировать его с SwashBuckle.Swagger. Он работает нормально, но когда я добавляю аутентификацию JWT, она не работает так, как я ожидаю. Для этого я добавил код ниже: services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo { Title = "My Web API", Version = …

10 swagger  asp.net-core-webapi  swashbuckle  .net-core-3.0