Вопросы по теме 'swagger-editor'

Swagger UI - чтение спецификаций JSON из редактора в UI без хостинга
Я пытаюсь задокументировать свой API с помощью Swagger, написав документацию в редакторе Swagger, а затем загрузив ее в пользовательский интерфейс Swagger. Я использовал редактор и загрузил свой файл JSON, а затем изменил файл /dist/index.html в...
3691 просмотров

Как указать, что pdf возвращается в чванстве?
У меня есть вызов get в моем API REST swagger, который должен вернуть файл PDF. Нет четкого примера/документации о том, как это сделать, не вызывая синтаксической ошибки. responses: 200: description: Returns PDF schema:...
17819 просмотров

Как указать столбцы в Swagger
Как указать 3 столбца в редакторе swagger, чтобы вывод выглядел так: a b c x y z swagger: '2.0' info: description: > This is a sample server Petstore server. [Learn...
3269 просмотров

Создайте свой собственный тип в Swagger
У меня есть этот YAML-код чванства, и мне нужно создать свой собственный тип (с именем MyOwnType). Если я использую "MyOwnType", возникает ошибка компиляции. paths: /in/total: get: summary: My summary. description: My...
3621 просмотров
schedule 31.05.2023

Пути, отличающиеся только именами параметров запроса
Я использую редактор swagger для документирования существующего API, который позволяет пути поддерживать два разных запроса, которые отличаются только именами параметров запроса. Например: swagger: '2.0' info: title: example version: 1.0.0...
232 просмотров
schedule 27.07.2023

Данные не соответствуют ни одной схеме из oneOf - Ошибка
Я получаю следующую ошибку в онлайн-редакторе swagger Данные не соответствуют ни одной схеме из 'oneOf' '/tenants/tenant_id/groups/group_id': get: description: 'Returns the group with specific id ( id, name, description, tenant_id... ) along...
3794 просмотров
schedule 26.02.2023

Как мне реорганизовать эту спецификацию API Swagger
У меня есть несколько конечных точек, где у меня есть стандартные ответы об ошибках, такие как 404 , 401 , 403 и default . Я хочу преобразовать эти ответы в определение Swagger, но я не могу этого добиться. Я пробовал несколько трюков, но это...
1140 просмотров

Swagger UI / Editor like page - добавить на мой веб-сайт
Я создал файл YAML (и файл JSON соответственно) вручную с помощью редактора swagger . Теперь я хочу встроить классную автоматически сгенерированную страницу из инструмента swagger-editor на свой веб-сайт, чтобы пользователи могли прочитать и...
9608 просмотров

Проблема с наследованием Swagger
У меня проблемы с использованием наследования с чванством. У меня есть следующее: { "swagger": "2.0", "info": { "title": "Uber API", "description": "Move your app forward with the Uber API", "version": "1.0.0"...
428 просмотров

Что я должен кодировать, если я хочу, чтобы swagger-editor сохранял на удаленном сервере
Я прочитал вопрос Какие варианты есть у swagger-editor для сохранения json или yaml в удаленный бэкэнд , но у меня все еще есть вопрос, где найти интерфейсный документ, который реализует бэкэнд-хранилище swagger-editor.
654 просмотров
schedule 09.10.2023

Почему Swagger не создает документацию по API для проекта Node.js?
Документ спецификации Swagger не создается из интеграции Swagger в проект Node.js в качестве подпроекта. Тем не менее, SwaggerUI запущен и работает. Если мы предоставим, скажем, файл swagger.json или api-docs.json, то он будет отображать...
2475 просмотров

Node.js TypeError: res.json не является функцией
Я пытаюсь создать простое приложение hello world, используя Swagger и Node.js, которое выводит «Hello», когда я вызываю GET, но получаю сообщение об ошибке: TypeError: res.json не является функцией . Используя редактор Swagger, я создал следующий...
9240 просмотров
schedule 07.02.2023

Могу ли я создать определение модели stub swagger из файла json
Есть ли инструмент, который позволяет мне создать модель определения Swagger yaml из образца JSON? Я бы пошел, отредактировал и очистил yaml, но было бы неплохо, если бы там было что-то, что заглушило бы структуру yaml на основе большого или...
3131 просмотров
schedule 07.01.2023

Как рекурсивно сослаться на определение включающего типа в OpenAPI / Swagger?
Я пишу определение OpenAPI в редакторе Swagger. Одно из моих определений типа содержит массив, содержащий дочерние элементы того же типа, что и родительский. Т.е. что-то вроде этого: definitions: TreeNode: type: object properties:...
9281 просмотров

Как изменить https: // ‹your-url› / swagger на пользовательский в Swagger
Мне было поручено установить Swagger в проект Web API. Установлено: самая последняя версия Swashbuckle от nuget. (Swashbuckle.Core.Net45 и Swashbuckle.Net45) Настроено: App_Start \ SwaggerConfig.cs. Я смог настроить (изменить стили, добавить...
9522 просмотров

Swagger - Изменить каталог проекта
Я создал новый проект ( nodeJS ) в корневом каталоге своего рабочего пространства и через некоторое время захотел разделить клиентскую и серверную часть проекта. Для этого я создал две папки (серверную и клиентскую) внутри корневого каталога проекта...
2433 просмотров

Как получить строку XML из POST RequestBody в сгенерированном Swagger коде сервера Spring?
Я хочу создать метод REST API, который получает строку XML, отправленную POST. Я использую Редактор Swagger для разработки своего REST API сверху вниз и для создания кода заглушки сервера. . Метод POST выглядит так в моем swagger.yaml :...
7215 просмотров

как создать фиктивный ответ из чванства
Как вы, возможно, знаете, Swagger сам предоставляет возможность протестировать API с помощью параметра «Попробовать», как в http://petstore.swagger.io/#!/pet/findPetsByStatus . Я не знаю, как swagger управляет этой опцией «попробовать», но я хочу...
455 просмотров
schedule 17.11.2023

Файл Swagger с предупреждением
Файл Swagger работает, как и ожидалось, с предупреждением. { 'swagger': "2.0", "info": { "version": "3.0", "title": "Sample Service", }, "schemes": [ "http" ], "host": "sampleservice.azurewebsites.net", "paths": { "/": {...
117 просмотров
schedule 10.09.2022

Swagger Local Editor изменить хост/порт службы
Я хочу использовать редактор Swagger для тестирования службы REST, развернутой с помощью Grizzly. Моя служба находится на другом порту (8081), а не на редакторе Swagger (8080). Как я могу указать редактору (локальному или онлайновому) использовать...
2003 просмотров
schedule 17.09.2022