Вопросы с меткой [swagger]

Используйте эту метку для вопросов относящихся к описанию api согласно спецификации OpenAPI 2 (aka Swagger) или относящихся к набору инструментов Swagger (Swagger Editor, Swagger UI). Для вопросов связанных со спецификацией OpenAPI 3 добавляйте метку [openapi].

Фильтрация
Сортировка
Метки
1 голос
0 ответов
26 показов

DRF не работают статичные файлы

Хочу добавить свой свагер используя схему open api Вот код url urlpatterns = [ path('admin/', admin.site.urls), path('api/', include('api.urls')), path('', include('payments.urls')), path('...
Maxim Zheldakov's user avatar
0 голосов
0 ответов
15 показов

Как реализовать авторизацию по токену в SPECTACULAR_UI?

Возникла проблема с авторизацией в моём SPECTACULAR. Для стандартной авторизации я использую knox. REST_FRAMEWORK = { 'EXCEPTION_HANDLER': 'api.errors_handler.errors_responses....
pshpth_ sht's user avatar
0 голосов
1 ответ
47 показов

Нет кнопки Authorize в swagger

Подскажите, нет кнопки авторизации в swagger, однако версионность отображается из кода (1.0) Моя конфигурация: @Configuration public class SwaggerConfig { protected static final String AUTH_NAME =...
Анастасия Бочкарева's user avatar
0 голосов
0 ответов
13 показов

Отправка XML в Swagger

Всем добрый день. Столкнулся вот с какой проблемой: Пишу аннотацию для Swagger. Есть POST-запрос. В тело этого запроса хочу передать XML, но не знаю как это сделать, помогите пожалуйста. Вот то, что ...
fenix_63's user avatar
0 голосов
0 ответов
9 показов

Swagger: как указать ссылку ра респонс для выбора необходимого варианта

Интересует вопрос: возможно ли в Swagger указать ссылку для респонса тела и выбора нужного варианта в зависимости от полученного ответа? Мне на каждый успешный запрос API отвечает 200, далее в теле ...
Николай's user avatar
0 голосов
0 ответов
25 показов

Model binding and validation в gin golang

Новичок в gin. Есть такой стракт с тегами: type BookSeries struct { PageParametersQuery Sort BookSeriesSort `json:"sort" example:"price,createdAt,updatedAt" enums:"...
maxim_tretyakov's user avatar
1 голос
1 ответ
20 показов

C#, webAPI, контроллер, swagger: каким аттрибутом задаётся комментарий?

жил я себе не тужил, расширял контроллеры своими методами, и писал атрибуты в стиле [HtpPost("А этот метод выдаёт отчет номер два!")] public async Task<List<string>> ...
S.H.'s user avatar
  • 10.8k
0 голосов
1 ответ
58 показов

Swagger: как через него скачать файл?

я польуюсь Swagger, когда делаю NET Core проекты с REST api интерфейсом. (обычно NET Core 6.0 или 7.0) И это невероятно удобно: если я описываю аргументы и результаты в контроллере, то я вижу на ...
S.H.'s user avatar
  • 10.8k
0 голосов
0 ответов
73 показа

Как создать документацию для эндпонтов в Swagger?

У меня нубский вопрос по сваггеру, с которым раньше никогда не работал. В общем, есть некое API на php (laravel), к которому мне поручили прикрутить Swagger документацию. Около 60 эндпоинтов. У многих ...
Ostet's user avatar
  • 63
1 голос
0 ответов
41 показ

Генерация VS Swagger с двойным наследием и дискриминатором

Замечание: VS использует для генерации кода NSwag библиотеки Есть сваггер: { "openapi": "3.0.1", "info": {...}, "servers": [...], "paths": {......
Дмитрий Чистик's user avatar
0 голосов
0 ответов
28 показов

csv response для swagger 2.0 & codegen (golang)

Пишу хэндлер, который в ответ присылает csv файл. На проекте используем swagger 2.0 в формате json и по нему codegen. Так вот есть несколько проблем: Когда запускаю генерацию кода по спецификации, то ...
stpepe's user avatar
  • 1
0 голосов
1 ответ
12 показов

Тестирование контроллера на основе openApi средствами osteel/openapi-httpfoundation-testing?

Требуется на основе документации из yaml проверить ответ контроллера средствами osteel/openapi-httpfoundation-testing. Загвоздка в том, что если в ответ добавить не описанные в документации поля, тест ...
Dilun7495's user avatar
  • 320
0 голосов
0 ответов
24 показа

Как отобразить несколько ответов с одним статусом в сваггере (nest)?

Всем привет! Пытаюсь сформировать документацию в апи через swagger и nestsjs В описании эндпоинта указываю несколько ответов с одним статусом, но отображается только один из них. @ApiResponse({ ...
Chumachenko Mihail's user avatar
1 голос
0 ответов
18 показов

APS.NET Ошибка при чтении CSV файла

Всем привет! Пытаюсь считать csv и вместо считанных строк Swagger выдает Failed to fetch. Possible Reasons: CORS Network Failure URL scheme must be "http" or "https" for CORS ...
Anton's user avatar
  • 11
0 голосов
0 ответов
28 показов

Как составлять endpoint и components для API?

Подскажите, пожалуйста, как правильно составлять эндпойнты на примере задачи? Есть научный портал. Основной сущностью портала являются научные статьи. У статей есть авторы. Статьи содержат следующие ...
artur123455432143's user avatar
0 голосов
0 ответов
13 показов

Почему x-tokenName игнорируется в swagger?

я хочу сделать oauth2 авторизацию с помощью google. Мне нужно чтобы swagger брал токен из id_token. Но когда я задаю значение для x-tokenName в id_token то ничего не происходит и параметр просто ...
Denis's user avatar
  • 11
0 голосов
0 ответов
27 показов

Как можно указать два пути для одного метода? laravel swagger

Пишу аннотации к api методам. У меня есть один метод в контроллере, но он используется в двух разных роутах. То есть: /api/v0/somemethod И: /api/v1/somemethod Библиотека для аннотаций: "...
vanesicks's user avatar
  • 468
0 голосов
0 ответов
44 показа

Проблема с реализацией выпадающего списка

Как сделать выпадающий список в Swagger документации в laravel? Подскажите пожалуйста, как добавить выпадающий список в @OA\Parameter, как я понял, нужно использовать enum, но от недостатка опыта ...
Игорь Ефтеев's user avatar
0 голосов
0 ответов
51 показ

Некорректное отображение ответа в Swagger'e

В проекте есть генерация кода на основе описания в yaml. В Swagger'e пример кода отображается не так, как хотелось бы. api.yaml: paths: /auth/registration: post: description: TODO ...
sololev's user avatar
  • 53
0 голосов
0 ответов
40 показов

springfox переехать на springdoc-openapi

Задача была с springfox переехать на springdoc-openapi все настройки легко переносится кроме одной @Bean public ServiceModelToSwagger2Mapper mapper() { return new ServiceModelToSwagger2MapperImpl()...
Serik Koder 's user avatar
0 голосов
2 ответа
118 показов

Как заполнить в symfony 6 данные для swagger(OpenApi)?

мне надо заполнит документацию для swagger. Похоже на этот @OA\Parameter( name="body", in="path", required=true, @OA\JsonContent( type="object", @OA\...
DLISM's user avatar
  • 29
0 голосов
1 ответ
84 показа

Как изменить пример ответа в Swagger UI?

Как изменить пример ответа для поля типа Decimal с 0 на 0,00 в Swagger UI? Пробовал вот это решение, но не получилось. Также отображает 0.
Russo's user avatar
  • 113
0 голосов
0 ответов
6 показов

Как прикрутить swagger к grails 5?

Нашел чью то либу swagger-grails-plugin, но доверия она не вызывает. Возможно кто то копал в этом направлении?
Anton Charov's user avatar
0 голосов
0 ответов
51 показ

FastAPI 422 "msg": "value is not a valid dict",

Есть следующий банальный код: class Test_upload(BaseModel): name: str @router.post("/add-project-file") def add_file(obj_in: Test_upload, file: List[UploadFile] = File()): return ...
Andrey Dolgopolov's user avatar
0 голосов
1 ответ
271 показ

Ошибка в swagger

Не могу разобраться, почему команда: swag init -d cmd/app/ --parseInternal --output api/openapi --parseDependency --parseDepth=1 Выдаёт вот такую ошибку: 2022/08/30 00:43:14 ParseFile error:/home/...
hedgehogues's user avatar
  • 9,261
0 голосов
0 ответов
10 показов

Как автоматически проверить бек-сервер по спеке OpenAPI на предмет 500-х ошибок?

Есть OpenAPI схема веб-сервиса, например возьмем официальную Swagger Petstore. В нем есть роут создания пользователя через POST /user: { "id": 10, "username": "theUser&...
Total Pusher's user avatar
  • 6,212
0 голосов
0 ответов
19 показов

Почему при вызове Get метода возвращается не результат, а html страницы swagger?

уважаемые посетители сайта. Мне нужна ваша помощь. Метод ниже вызывается с другого сервера и он должен вернуть объект. @Get('getAdvancedInfoKeywordsByIds') @ApiOperation({ summary: 'get ...
Viktoria Nurieva's user avatar
0 голосов
1 ответ
156 показов

Как загрузить swagger-ui на сервер в интернете?

Я создал API swagger на C#, смог выложить сайт на React с помощью сервиса netlify. Теперь хочу, чтобы моё API работало не только если я его запущу, а чтобы оно было на удаленном сервере, но не знаю ...
G-genius's user avatar
0 голосов
0 ответов
103 показа

Как убрать дублирвоание параметров метода в swagger?

Всем привет. Использую swagger v3. Контроллер принимает параметр. Для документирования этого параметра, вешую аннотацию @Parameter. Но не на параметр метода, а в общий блок @Operation над методом. Из-...
Artsiom Bondarau's user avatar
0 голосов
0 ответов
24 показа

Swagger and FormResponse

Всем привет, в общем есть некий контроллер с GET запросами. Эти запросы отображаются в Swagger. Однако, так как я использую для передачи информации собственно ручно написанный FormResponse, модель не ...
Bob Braun's user avatar
0 голосов
1 ответ
64 показа

Как в swagger передавать параметры в переиспользуемый компонент?

В успешном ответе каждого запроса повторяется данная структура: status: type: string message: nullable: true type: string data: type: object Хотел запихнуть ее в переиспользуемые компоненты, ...
Midia002's user avatar
0 голосов
1 ответ
51 показ

Почему response body пустой?

Написал аутентификацию, которая возвращает все данные пользователя, если login и password введены верно. Тут всё хорошо. Код файла DataBaseManager: public static User AuthUser(User user) { ...
Danila's user avatar
  • 89
0 голосов
1 ответ
58 показов

Для действий требуется уникальная комбинация метода/пути для Swagger/OpenAPI 3.0

Пытаюсь сделать клиент-серверное приложение. Создал два HttpPost, но он ругается на, как я понял, одинаковые пути. An unhandled exception occurred while processing the request. ...
Danila's user avatar
  • 89
0 голосов
0 ответов
23 показа

SpringDoc. Отображение html iframe

Я использую библиотеку "org.springdoc:springdoc-openapi-ui:1.6.8" Для вывода iframe использую след.конструкцию return ResponseEntity .ok() .contentType(...
Sergey's user avatar
  • 1
-1 голос
1 ответ
124 показа

Изменить заголовок для API в redoc и swagger

Настраиваю отображение в redoc и swagger, operation_id я изменяю, они меняются, как видно на скриншоте, мне нужно поменять название "events" на "Мероприятия". использую библиотеку ...
Vladimir Babaev's user avatar
0 голосов
1 ответ
743 показа

Не работает Swagger в браузере (OpenApi), микросервис SpringBoot

Коллеги нужна ваша помощь, обычный Rest микросервис SpringBoot, хочу сделать документацию, подключил зависимость: <dependency> <groupId>org.springdoc</groupId> <artifactId>...
LittleBudda's user avatar
1 голос
0 ответов
36 показов

Djanogo swagger https

Используя связку django который работает на nginx. Пытаюсь подключить https, собственно это мне удалось, сайт доступен по протоколу https но вот свагер по дефолту отправляет запросы на http, что ...
over's user avatar
  • 21
0 голосов
1 ответ
374 показа

Генерация dto при помощи OpenAPI Specification (Swagger)

Всем привет! Возможно ли используя json cхему генерировать Dto на Java при помощи Swagger? Если кто сталкивался с такой проблемой, буду рад рассмотреть другие варианты конвертации json -> Dto
Saintka's user avatar
  • 70
0 голосов
1 ответ
103 показа

Swagger поля для отправки запроса

Делаю авто документацию при помощи django swagger. Заметил такую вещь, что некоторые запросы имеют поле для ввода, например тут поле id имеет отдельную форму А некоторые функции таких полей не имеют ...
over's user avatar
  • 21
0 голосов
1 ответ
38 показов

Guava version (FluentIterable) - ошибка старта приложения

Ранее в зависимостях (использую maven с pom.xml) была зависимость на Guava с версией 15.0, подключил Swagger: <dependency> <groupId>io.springfox</groupId> <...
Revasha's user avatar
  • 102
0 голосов
0 ответов
37 показов

Прослушивать два порта для двух разные Swagger UI ASP .NET Core

Всем привет, У меня есть web приложение на ASP .net Core (C#), которое сейчас прослушивает один порт. По адресу и этому одному порту выдает Swagger, хочу чтобы приложение начало слушать второй порт и ...
Samson goot's user avatar
0 голосов
1 ответ
80 показов

WEB API Swagger error

Всем привет. Пытаюсь к своей API добавить swagger. Проект был создан по дефолтному шаблону Web API. Добавил свои методы, реализацию. Однако на данный момент при запуске появляется такая ошибка: My ...
Кирилл Филободченко's user avatar
0 голосов
0 ответов
33 показа

проект на vuejs

я начинающий во фронтенде, попал недавно в школу от IT комании, где нам дали проект. Нас в команде трое(2 фронта и 1 бэк). Так вот,я вообще не понимаю с чего начать,как сделать первые шаги,что ...
Pavel's user avatar
  • 138
1 голос
1 ответ
161 показ

Swagger не генерирует requestBody в моём ASP.NET Core Web Api

Пытаюсь настроить Swagger для своего Web Api. Настраивал в соответствии с https://docs.microsoft.com/ru-ru/aspnet/core/tutorials/getting-started-with-swashbuckle?view=aspnetcore-5.0&tabs=visual-...
Sergey Zhelezny's user avatar
1 голос
1 ответ
38 показов

Добавить uri param для GET-контроллера в приложении на flask-restplus

Хотел бы добавить добавить uri parameter для GET-контроллера. Полностью код доступен здесь (пример взят из оф. репозитория flask-restplus) Есть модель: todo = api.model('Todo', { 'id': fields....
Dealenx's user avatar
  • 152
1 голос
1 ответ
623 показа

Как изменить baseUrl в springfox swagger

Я использую Springfox Swagger2 со Swagger UI. Swagger UI доступен по ссылке http://localhost:8090/swagger-ui/ Как мне изменить этот адрес на другой, например: http://localhost:8090/my/custom/path/...
RomanMitasov's user avatar
0 голосов
1 ответ
49 показов

c# Swagger отображение IFormFile в классе

Пробовал добавлять настройки: c.SchemaGeneratorOptions.CustomTypeMappings.Add(typeof(IFormFile), () => new OpenApiSchema() { Type = "file", Format = "binary" }); c.MapType(...
Ivan G. Zakirov's user avatar
1 голос
1 ответ
463 показа

Переопределение представления LocalTime в springdoc

Столкнулся с проблемой представления LocalTime в swagger(использую springdoc). To, что было изначально: Dto, где возникла проблема: @Data @AllArgsConstructor @NoArgsConstructor @Builder public class ...
Anton Kolesov's user avatar
3 голоса
2 ответа
528 показов

Как сконфигурировать Swagger Spring (non-boot)

Моя конфигурация выглядит так: <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <...
Elizaveta's user avatar
  • 386
0 голосов
0 ответов
48 показов

Swagger Можно ли документировать проект, а не только часть RestAPi?

Может ли Swagger документировать не только ту часть проекта что связана с restApi, на и некоторые внутренние объекты, к примеру некоторые сервисы и прочие ? Хотелось бы добавить по мимо документации ...
JamesBondCaesar's user avatar