Вопросы с меткой [swagger]
Используйте эту метку для вопросов относящихся к описанию api согласно спецификации OpenAPI 2 (aka Swagger) или относящихся к набору инструментов Swagger (Swagger Editor, Swagger UI). Для вопросов связанных со спецификацией OpenAPI 3 добавляйте метку [openapi].
117
вопросов
1
голос
0
ответов
26
показов
DRF не работают статичные файлы
Хочу добавить свой свагер используя схему open api
Вот код url
urlpatterns = [
path('admin/', admin.site.urls),
path('api/', include('api.urls')),
path('', include('payments.urls')),
path('...
0
голосов
0
ответов
15
показов
Как реализовать авторизацию по токену в SPECTACULAR_UI?
Возникла проблема с авторизацией в моём SPECTACULAR. Для стандартной авторизации я использую knox.
REST_FRAMEWORK = {
'EXCEPTION_HANDLER': 'api.errors_handler.errors_responses....
0
голосов
1
ответ
47
показов
Нет кнопки Authorize в swagger
Подскажите, нет кнопки авторизации в swagger, однако версионность отображается из кода (1.0)
Моя конфигурация:
@Configuration
public class SwaggerConfig {
protected static final String AUTH_NAME =...
0
голосов
0
ответов
13
показов
Отправка XML в Swagger
Всем добрый день. Столкнулся вот с какой проблемой: Пишу аннотацию для Swagger. Есть POST-запрос. В тело этого запроса хочу передать XML, но не знаю как это сделать, помогите пожалуйста.
Вот то, что ...
0
голосов
0
ответов
9
показов
Swagger: как указать ссылку ра респонс для выбора необходимого варианта
Интересует вопрос: возможно ли в Swagger указать ссылку для респонса тела и выбора нужного варианта в зависимости от полученного ответа?
Мне на каждый успешный запрос API отвечает 200, далее в теле ...
0
голосов
0
ответов
25
показов
Model binding and validation в gin golang
Новичок в gin.
Есть такой стракт с тегами:
type BookSeries struct {
PageParametersQuery
Sort BookSeriesSort `json:"sort" example:"price,createdAt,updatedAt" enums:"...
1
голос
1
ответ
20
показов
C#, webAPI, контроллер, swagger: каким аттрибутом задаётся комментарий?
жил я себе не тужил, расширял контроллеры своими методами, и писал атрибуты в стиле
[HtpPost("А этот метод выдаёт отчет номер два!")]
public async Task<List<string>> ...
0
голосов
1
ответ
58
показов
Swagger: как через него скачать файл?
я польуюсь Swagger, когда делаю NET Core проекты с REST api интерфейсом. (обычно NET Core 6.0 или 7.0)
И это невероятно удобно: если я описываю аргументы и результаты в контроллере, то я вижу на ...
0
голосов
0
ответов
73
показа
Как создать документацию для эндпонтов в Swagger?
У меня нубский вопрос по сваггеру, с которым раньше никогда не работал.
В общем, есть некое API на php (laravel), к которому мне поручили прикрутить Swagger документацию. Около 60 эндпоинтов. У многих ...
1
голос
0
ответов
41
показ
Генерация VS Swagger с двойным наследием и дискриминатором
Замечание: VS использует для генерации кода NSwag библиотеки
Есть сваггер:
{
"openapi": "3.0.1",
"info": {...},
"servers": [...],
"paths": {......
0
голосов
0
ответов
28
показов
csv response для swagger 2.0 & codegen (golang)
Пишу хэндлер, который в ответ присылает csv файл. На проекте используем swagger 2.0 в формате json и по нему codegen. Так вот есть несколько проблем:
Когда запускаю генерацию кода по спецификации, то ...
0
голосов
1
ответ
12
показов
Тестирование контроллера на основе openApi средствами osteel/openapi-httpfoundation-testing?
Требуется на основе документации из yaml проверить ответ контроллера средствами osteel/openapi-httpfoundation-testing.
Загвоздка в том, что если в ответ добавить не описанные в документации поля, тест ...
0
голосов
0
ответов
24
показа
Как отобразить несколько ответов с одним статусом в сваггере (nest)?
Всем привет!
Пытаюсь сформировать документацию в апи через swagger и nestsjs
В описании эндпоинта указываю несколько ответов с одним статусом, но отображается только один из них.
@ApiResponse({
...
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 ...
0
голосов
0
ответов
28
показов
Как составлять endpoint и components для API?
Подскажите, пожалуйста, как правильно составлять эндпойнты на примере задачи?
Есть научный портал. Основной сущностью портала являются научные статьи. У статей есть авторы. Статьи содержат следующие ...
0
голосов
0
ответов
13
показов
Почему x-tokenName игнорируется в swagger?
я хочу сделать oauth2 авторизацию с помощью google. Мне нужно чтобы swagger брал токен из id_token. Но когда я задаю значение для x-tokenName в id_token то ничего не происходит и параметр просто ...
0
голосов
0
ответов
27
показов
Как можно указать два пути для одного метода? laravel swagger
Пишу аннотации к api методам.
У меня есть один метод в контроллере, но он используется в двух разных роутах.
То есть: /api/v0/somemethod
И: /api/v1/somemethod
Библиотека для аннотаций:
"...
0
голосов
0
ответов
44
показа
Проблема с реализацией выпадающего списка
Как сделать выпадающий список в Swagger документации в laravel?
Подскажите пожалуйста, как добавить выпадающий список в @OA\Parameter, как я понял, нужно использовать enum, но от недостатка опыта ...
0
голосов
0
ответов
51
показ
Некорректное отображение ответа в Swagger'e
В проекте есть генерация кода на основе описания в yaml. В Swagger'e пример кода отображается не так, как хотелось бы.
api.yaml:
paths:
/auth/registration:
post:
description: TODO
...
0
голосов
0
ответов
40
показов
springfox переехать на springdoc-openapi
Задача была с springfox переехать на springdoc-openapi
все настройки легко переносится кроме одной
@Bean
public ServiceModelToSwagger2Mapper mapper() {
return new ServiceModelToSwagger2MapperImpl()...
0
голосов
2
ответа
118
показов
Как заполнить в symfony 6 данные для swagger(OpenApi)?
мне надо заполнит документацию для swagger.
Похоже на этот
@OA\Parameter(
name="body",
in="path",
required=true,
@OA\JsonContent(
type="object",
@OA\...
0
голосов
1
ответ
84
показа
Как изменить пример ответа в Swagger UI?
Как изменить пример ответа для поля типа Decimal с 0 на 0,00 в Swagger UI? Пробовал вот это решение, но не получилось. Также отображает 0.
0
голосов
0
ответов
6
показов
Как прикрутить swagger к grails 5?
Нашел чью то либу swagger-grails-plugin, но доверия она не вызывает. Возможно кто то копал в этом направлении?
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 ...
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/...
0
голосов
0
ответов
10
показов
Как автоматически проверить бек-сервер по спеке OpenAPI на предмет 500-х ошибок?
Есть OpenAPI схема веб-сервиса, например возьмем официальную Swagger Petstore.
В нем есть роут создания пользователя через POST /user:
{
"id": 10,
"username": "theUser&...
0
голосов
0
ответов
19
показов
Почему при вызове Get метода возвращается не результат, а html страницы swagger?
уважаемые посетители сайта. Мне нужна ваша помощь. Метод ниже вызывается с другого сервера и он должен вернуть объект.
@Get('getAdvancedInfoKeywordsByIds')
@ApiOperation({
summary: 'get ...
0
голосов
1
ответ
156
показов
Как загрузить swagger-ui на сервер в интернете?
Я создал API swagger на C#, смог выложить сайт на React с помощью сервиса netlify. Теперь хочу, чтобы моё API работало не только если я его запущу, а чтобы оно было на удаленном сервере, но не знаю ...
0
голосов
0
ответов
103
показа
Как убрать дублирвоание параметров метода в swagger?
Всем привет. Использую swagger v3. Контроллер принимает параметр. Для документирования этого параметра, вешую аннотацию @Parameter. Но не на параметр метода, а в общий блок @Operation над методом.
Из-...
0
голосов
0
ответов
24
показа
Swagger and FormResponse
Всем привет, в общем есть некий контроллер с GET запросами. Эти запросы отображаются в Swagger. Однако, так как я использую для передачи информации собственно ручно написанный FormResponse, модель не ...
0
голосов
1
ответ
64
показа
Как в swagger передавать параметры в переиспользуемый компонент?
В успешном ответе каждого запроса повторяется данная структура:
status:
type: string
message:
nullable: true
type: string
data:
type: object
Хотел запихнуть ее в переиспользуемые компоненты, ...
0
голосов
1
ответ
51
показ
Почему response body пустой?
Написал аутентификацию, которая возвращает все данные пользователя, если login и password введены верно. Тут всё хорошо.
Код файла DataBaseManager:
public static User AuthUser(User user)
{
...
0
голосов
1
ответ
58
показов
Для действий требуется уникальная комбинация метода/пути для Swagger/OpenAPI 3.0
Пытаюсь сделать клиент-серверное приложение.
Создал два HttpPost, но он ругается на, как я понял, одинаковые пути.
An unhandled exception occurred while processing the request.
...
0
голосов
0
ответов
23
показа
SpringDoc. Отображение html iframe
Я использую библиотеку "org.springdoc:springdoc-openapi-ui:1.6.8"
Для вывода iframe использую след.конструкцию
return ResponseEntity
.ok()
.contentType(...
-1
голос
1
ответ
124
показа
Изменить заголовок для API в redoc и swagger
Настраиваю отображение в redoc и swagger, operation_id я изменяю, они меняются, как видно на скриншоте, мне нужно поменять название "events" на "Мероприятия". использую библиотеку ...
0
голосов
1
ответ
743
показа
Не работает Swagger в браузере (OpenApi), микросервис SpringBoot
Коллеги нужна ваша помощь, обычный Rest микросервис SpringBoot, хочу сделать документацию, подключил зависимость:
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>...
1
голос
0
ответов
36
показов
Djanogo swagger https
Используя связку django который работает на nginx. Пытаюсь подключить https, собственно это мне удалось, сайт доступен по протоколу https но вот свагер по дефолту отправляет запросы на http, что ...
0
голосов
1
ответ
374
показа
Генерация dto при помощи OpenAPI Specification (Swagger)
Всем привет! Возможно ли используя json cхему генерировать Dto на Java при помощи Swagger?
Если кто сталкивался с такой проблемой, буду рад рассмотреть другие варианты конвертации
json -> Dto
0
голосов
1
ответ
103
показа
Swagger поля для отправки запроса
Делаю авто документацию при помощи django swagger. Заметил такую вещь, что некоторые запросы имеют поле для ввода, например тут поле id имеет отдельную форму
А некоторые функции таких полей не имеют
...
0
голосов
1
ответ
38
показов
Guava version (FluentIterable) - ошибка старта приложения
Ранее в зависимостях (использую maven с pom.xml) была зависимость на Guava с версией 15.0, подключил Swagger:
<dependency>
<groupId>io.springfox</groupId>
<...
0
голосов
0
ответов
37
показов
Прослушивать два порта для двух разные Swagger UI ASP .NET Core
Всем привет,
У меня есть web приложение на ASP .net Core (C#), которое сейчас прослушивает один порт. По адресу и этому одному порту выдает Swagger, хочу чтобы приложение начало слушать второй порт и ...
0
голосов
1
ответ
80
показов
WEB API Swagger error
Всем привет. Пытаюсь к своей API добавить swagger. Проект был создан по дефолтному шаблону Web API. Добавил свои методы, реализацию. Однако на данный момент при запуске появляется такая ошибка:
My ...
0
голосов
0
ответов
33
показа
проект на vuejs
я начинающий во фронтенде, попал недавно в школу от IT комании, где нам дали проект.
Нас в команде трое(2 фронта и 1 бэк).
Так вот,я вообще не понимаю с чего начать,как сделать первые шаги,что ...
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-...
1
голос
1
ответ
38
показов
Добавить uri param для GET-контроллера в приложении на flask-restplus
Хотел бы добавить добавить uri parameter для GET-контроллера.
Полностью код доступен здесь (пример взят из оф. репозитория flask-restplus)
Есть модель:
todo = api.model('Todo', {
'id': fields....
1
голос
1
ответ
623
показа
Как изменить baseUrl в springfox swagger
Я использую Springfox Swagger2 со Swagger UI.
Swagger UI доступен по ссылке
http://localhost:8090/swagger-ui/
Как мне изменить этот адрес на другой, например:
http://localhost:8090/my/custom/path/...
0
голосов
1
ответ
49
показов
c# Swagger отображение IFormFile в классе
Пробовал добавлять настройки:
c.SchemaGeneratorOptions.CustomTypeMappings.Add(typeof(IFormFile), () => new OpenApiSchema() { Type = "file", Format = "binary" });
c.MapType(...
1
голос
1
ответ
463
показа
Переопределение представления LocalTime в springdoc
Столкнулся с проблемой представления LocalTime в swagger(использую springdoc).
To, что было изначально:
Dto, где возникла проблема:
@Data
@AllArgsConstructor
@NoArgsConstructor
@Builder
public class ...
3
голоса
2
ответа
528
показов
Как сконфигурировать Swagger Spring (non-boot)
Моя конфигурация выглядит так:
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<...
0
голосов
0
ответов
48
показов
Swagger Можно ли документировать проект, а не только часть RestAPi?
Может ли Swagger документировать не только ту часть проекта что связана с restApi, на и некоторые внутренние объекты, к примеру некоторые сервисы и прочие ? Хотелось бы добавить по мимо документации ...