Запитання з тегом «swagger»

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

135 c#  asp.net  .net  swagger 

Нещодавно я писав спокійні API з SpringMvc та swagger -ui (v2). Я помітив функцію імпорту в поштарці: Тож моє запитання - як створити файл, який потрібен був Листоноші? Я не знайомий із Сваггером.

120 swagger  postman 

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

112 swagger  swagger-2.0  swagger-editor 

Мій проект має Spring Security. Основна проблема: Не вдалося отримати доступ до URL-адреси, що розміщується, за адресою http: // localhost: 8080 / api / v2 / api-docs . Там написано Заголовок авторизації відсутній або недійсний. Знімок екрана вікна браузера Мій pom.xml містить такі записи <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.4.0</version> </dependency> <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, без вишуканих речей!). Мені потрібно застосувати в цьому Суаггера. Поки що КОЖНА сторінка в Інтернеті зводила мене з розуму лише заплутаними конфігураціями та роздутим кодом, який я взагалі не знайшов портативним. Хто-небудь має зразок проекту (або набір детальних кроків), …

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 

У моєму "спрощеному" API всі відповіді виводяться ( успадковуються ) з базового класу "відповіді". Клас відповіді складається із заголовка, заповненого метаданими, та тіла, що містить основні дані, які користувач запитує. Відповідь (у форматі JSON) викладена таким чином, що всі метадані знаходяться на першому "шарі", а тіло є єдиним атрибутом, що …

82 swagger 

У мене є деякі кінцеві точки в API - /user/login,/products . У Сваггер інтерфейс I поста emailі passwordдо /user/loginі у відповідь я отримуюtoken рядок. Потім я можу скопіювати маркер із відповіді і хочу використовувати його як Authorizationзначення заголовка в запитах на всі URL-адреси, якщо він присутній, і /productsяк приклад. Чи …

80 api  authorization  swagger  swagger-ui 

У мене є декларація API Swagger для служб, що використовують Swagger v 1.2 Моє первісне відчуття щодо Суаггера полягало в тому, що він дуже близький до схеми JSON (проект 3 і останнім часом проект 4), і буде відносно легко сформувати схему JSON для об'єктів запиту та відповіді. Однак, хоча частина …

74 swagger  jsonschema 

Останні два роки я працював над Spring Boot Applications з Springfox. Springfox генерує документацію та тестовий інтерфейс для вашого REST API. Це було приголомшливо. Але насправді проект Springfox мертвий і не підтримує новітню весну. У мене три питання Чи є інший спосіб безпосередньо створити інтерфейс Swagger? Будь-яка інша бібліотека / …

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 = "v1" …

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