Вопросы с меткой [swagger]
Используйте эту метку для вопросов относящихся к описанию api согласно спецификации OpenAPI 2 (aka Swagger) или относящихся к набору инструментов Swagger (Swagger Editor, Swagger UI). Для вопросов связанных со спецификацией OpenAPI 3 добавляйте метку [openapi].
77
вопросов
0
голосов
0ответов
13 показов
Как отключить проверку на response?
У меня бекенд написан на Hapi js, подключен Swagger и Joi, при добавлении какого-либо поля при ответе нужно постоянно менять и response для сваггера, иначе валится 500, как отключить это?
response:
{
...
0
голосов
0ответов
8 показов
swagger documentation get param
get:
tags:
- resource
summary: Получение данных
operationId: resource/res
parameters:
- name: planMonth
in: query
description: 'Формат даты (формат: ...
2
голоса
0ответов
19 показов
Не отображается swagger-ui.html в open-api на сервере
Использую Spring-Boot 2.x.x, gradle 6, Java 8
И хотел перейти с Swagger 2 на Open api (Swagger 3)
В Swagger 2 таких проблем не было
dependencies {
implementation('org.springdoc:springdoc-openapi-...
0
голосов
0ответов
16 показов
Как задать по умолчанию пустой лист в swagger codegen
Есть сущность с полем
cises:
type: array
description: Массив марок. Длина должна совпадать со значением поля quantity, либо массив должен быть пустым
...
0
голосов
0ответов
11 показов
Swagger + python
В силу работы, пришлось разбираться и работать со swagger.
Мне бэк разработчик дал документацию и сказал запустить ее в swagger.edit.
Я понял что если туда загрузить файл, то я получу документацию в ...
0
голосов
0ответов
49 показов
Неверный request url в swagger при запросе через ocelot
При запросах через страницу swagger в gateway, в запрос подставляется порт gateway, а не приложения за ним, возникает ошибка 404.
При запросах в swagger через прямой адресс к приложению (127.0.0.1:...
0
голосов
0ответов
12 показов
Монтирование скемы в drf_yasg или drf_spectacular
Есть два проекта на Django + RestFramework (далее A и B).
В проекте А есть ProxyView который принимает любые (GET, POST, PUT...) запросы и перенаправляет на проект B.
Условно выглядит вот так:
# ...
1
голос
0ответов
32 показа
Как я могу использовать механизмы наследования и swagger в своем API одновременно?
Большая часть моих методов в API реализовано по такой схеме:
[Route("api/[controller]")]
public class SomeController : ApiContriollerBase<SomeRequestModel>
{
public override void ...
0
голосов
1ответ
17 показов
Не работает swagger-ui на сервере, обращается по localhost вместо доменного имен
к сожалению, столкнулся с такой проблемой, что не работает апи в свагере (swagger-ui), запросы обращаются по localhost вместо имени домена (my.domain.ru), проблема не в приложении, а в сервере, так ...
1
голос
2ответа
23 показа
Как записать в формате Swagger / OpenAPI такие параметры
Делаю схему сваггера, но не понимаю как правильно указать параметры фильтрации для пакета Laravel query builder.
Вот пример:
/users?filter[name]=john&filter[email]=gmail
Как записать схему для ...
0
голосов
1ответ
16 показов
Swagger как настроить отображение spring data rest вручную?
есть сервис на spring boot, в нем используется spring data rest. В помнике подключаю стартер.
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-boot-...
0
голосов
1ответ
51 показ
Не отображаются методы в документации Swagger
Подключил Swagger к проекту, по мануалу с MSDN, при тестировании в веб проекте все нужные и не нужные методы добавляются в список отображения, исключил не нужные с помощью [ApiExplorerSettings(...
0
голосов
0ответов
27 показов
Почему JsonView и Swagger не хотят дружить?
Никак не могу понять почему мои JsonView и Swagger не дружат
Swagger отображает пустые JsonView что бы я ни делал
Swagger:
compile 'io.springfox:springfox-boot-starter:3.0.0'
compile 'io....
1
голос
1ответ
33 показа
Retrofit2 and Swagger PetStore Запрос пользователя
уважаемые знатоки, у меня возникла проблема с подключением к тестовой API Swagger.
Суть проблемы в том что при запросе к https://petstore.swagger.io/v2/ с использованием пути user{username} у меня ...
2
голоса
1ответ
39 показов
Swagger для Asp.Net. Api возвращает анонимный тип. Можно ли в swaggerUi показывать пример ответа?
Методы моих Api контроллеров принимают тип object в качестве параметра (json) и возвращают object (json) в ответ, который формируется в хранимых процедурах.
public Object TestSwagger(Object ...
0
голосов
1ответ
40 показов
Как использовать существующий swagger.yaml для создания API документации?
Имеется готовый swagger.yaml возможно ли по нему воссоздать API документацию, например, на Джанге через django-rest-swagger. Как создать с нуля приблизительно понял, однако нет понятия об этом yaml'е, ...
0
голосов
0ответов
29 показов
Отсутствует элемент в Swagger - UI
Использую Swagger + Spring Boot + multipart/mixed. Пишу контроллер, который принимает в себя 3 файла и объект(в Swagger заносится json'ом), код выглядит следующим образом:
@PostMapping(value = "/...
0
голосов
2ответа
36 показов
Запуск swagger_server через uWSGI
Мой сгенерированный swagger_server отлично работает при запуске с:
python3 -m swagger_server
#!/usr/bin/env python3
import connexion
from swagger_server import encoder
def main():
app = ...
0
голосов
1ответ
16 показов
Swagger conditional example
есть схема "фото транспортного средства"
VehiclePhoto:
type: object
properties:
id:
type: integer
example: "123"
url:
type: string
example: &...
0
голосов
1ответ
21 показ
swagger отправить ассоциативный массив
Как через swagger отправить данные form-data
currency[0][currency_id] = 5
currency[0][is_default] = true
currency[1][currency_id] = 1
currency[1][is_default] = false
currency[2][currency_id] = 3
...
1
голос
0ответов
21 показ
swagger2 springboot whitelabel error page
Подключаю сваггер по мануалу https://www.baeldung.com/swagger-2-documentation-for-spring-rest-api
@Configuration
@EnableSwagger2
public class SpringFoxConfig {
@Bean
public Docket api() {
...
1
голос
1ответ
43 показа
Nest.js как правильно задать ApiHeader?
Описываю ответ метода через @nestjs/swagger.
Хочу, чтобы в ui в графе "Media type" было видно, что сервер отвечает с заголовком content-type: application/xml (по умолчанию там пишут json).
...
0
голосов
2ответа
33 показа
Как убрать Swagger Petstore из своего проекта
В spring проекте перешел со swagger v. 2 на springdoc-openapi (swagger v. 3), все настроил, все работает, но по при использовании по умолчанию в URL добавляется index.html, т.е. начинаю работать с ...
1
голос
1ответ
33 показа
swagger openapi произвольные параметры в запросе
В api есть путь с произвольным количеством необязательных параметров примерно такого вида:
/orders/123/get-payment-link/provider?customerId=123&amount=2000&custom1=custom1&custom2=custom2.....
0
голосов
0ответов
35 показов
Swagger: как прикрутить собственный json с api-docs?
В сваггере, при желании, можно скачать json с api-docs, в котором будет вся та же сгенерированная сваггером информация, которая отображена в графическом интерфейсе. Я хочу отделить документацию от ...
0
голосов
0ответов
12 показов
Использование openapi.yaml в springdoc
Есть простой springboot проект с одним @RestController.
Можно программно настраивать open api
Хочу сделать тоже самое, но с помощью openapi.yaml файла, как в swagger-petstore примере.
Создаю нужный ...
1
голос
1ответ
100 показов
Настройка NGINX для api swagger
Столкнулся с такой проблемой. Есть докер с NGINX в нем настроен проект. Есть ли возможность настроить NGINX, чтобы он обрабатывал не только https://example.com/api, а https://example.com/jshfsh/api, ...
0
голосов
0ответов
20 показов
Как сделать ввод объектов в Swagger?
У меня есть 2 объекта, например статья и пользователь:
public class Article
{
[Key, ScaffoldColumn(false)]
public string Id { get; set; }
[Required]
public string Name { get; set; }
...
1
голос
2ответа
104 показа
Отличия swagger и openAPI
В чём отличия между swagger и openAPI? Это два разныъ проекта. Но на вики сказано, что это одно и то же.
0
голосов
0ответов
15 показов
offline swagger generator
Я хочу уметь генерировать код клиентов для своих сервисов оффлайн. Но не онлайн. На странице официальной документации к сваггеру, я нашёл кейс только для онлайн генерации. Есть ли оффлайн генераторы, ...
0
голосов
1ответ
147 показов
Как подключить swagger ui?
Я сделал по инструкции подключил swagger к asp.net, и я зайдя по swagger/v1/swagger.json, вижу json, с моими методами.
public void ConfigureServices(IServiceCollection services)
{
...
0
голосов
0ответов
19 показов
Передача ключа и сертификата в swagger-ui
Имеется приложение на Spring Boot. Подключил swagger (springfox).
Для его нормальной работы на моем стенде, мне нужно передать ключ и сертификат.
Если я использую curl, то запрос вида:
curl --key /...
0
голосов
0ответов
19 показов
Кодогенерация ручек сервера. Swagger+jinja + c++
Хотелось бы составлять API на swagger'e в yaml по типу:
...
/handler:
parameters:
- in: query
name: name
required: true
type: string
description: Object name
get:
...
0
голосов
1ответ
20 показов
Как вывести на экран через Swagger методы service-классов?
Пишу простое web-приложение. Со Spring boot и Swagger знаком недавно. Использую Spring-MVC, соответственно, имеются: pojo-класс Admin(model), класс-контроллер AdminController(controller), и ...
1
голос
1ответ
15 показов
Описать void как тип responce d в YAML кодогенерации Swagger
У меня есть post запрос который ничего не должен возвращать. он передает body.
Описан у меня в yaml таким образом
/voidName:
post:
operationId: voidName
tags:
- voidName
...
0
голосов
1ответ
27 показов
Проблема с формированием роутов после подключения swagger
Подключил в проект swagger. Обнаружил что он затягивает только те action's, в которых прописан роут. Пустой [HttpGet] или [HttpGet()] не катит.
Проблема в дефолтном роуте.
Т.е. можно так:
http://...
0
голосов
0ответов
10 показов
Как отрендерить загруженный swagger-file?
В своем Vue компоненте с формой я загружаю openapi файл. Я хочу его отрендерить при помощи либы swagger ui. Как это можно сделать? Я хочу вывести что-то такое:
0
голосов
1ответ
25 показов
Как интегрировать Swagger в Jenkins
Имеется java проект на Spring
К проекту подключен Swagger
Теперь нужно подключить проект к Jenkins, получилось только добавить просто проект (папки, файлы и т.д.), а нужно чтобы там появился ...
0
голосов
0ответов
31 показ
Ошибка внедрения зависимости в Swagger для аттрибута [FromService] метода контроллера
уважаемые разработчики. Мне нужно помочь научить Swagger работать с зависимостями для параметров методов контроллера, гугление не помогло.
Проект на ASP.NET MVC Core 3.1
Есть метод контроллера, ...
1
голос
1ответ
64 показа
Убрать элементы названий контроллеров из Swagger-UI
Использую swagger 2.9 в проекте
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</...
0
голосов
0ответов
63 показа
Swagger - ошибка пути
В Swagger есть проблема на вызов реста возвращающий List<Map<String, Object>> (вверху появляется сообщение)
Errors
Resolver error at paths./api/v1/getEntity/{integrationCode}.post....
0
голосов
1ответ
19 показов
python dredd hook
Есть файл, где прописанно описание API
test.yaml
swagger: '2.0'
info:
description: Api Documentation
version: '1.0'
title: Api Documentation
termsOfService: urn:tos
contact: {}
license:
...
0
голосов
0ответов
245 показов
POST запрос проходит тест в Postman но не проходит в Swagger UI
Есть следующий POST запрос:
@PostMapping(produces = MediaType.MULTIPART_FORM_DATA_VALUE)
public ResponseEntity<Object> newApplicationsRequest(
@Valid @RequestPart("json") ...
0
голосов
0ответов
47 показов
Swagger, Multiple custom attributes of the same type found
В модели я использую атрибуты.
Для одного и того же свойства использую RequiredAttribute и унаследованный от него кастомный атрибут.
Swagger ругается на такое - Multiple custom attributes of the same ...
1
голос
0ответов
45 показов
Swagger не воспринимает JsonPropertyName атрибут введённый в .net core 3.0 [закрыт]
У нас есть Web API проект на .Net Core 2.2. Настроен Swagger и есть следующая модель
public class ProjectCreateDto
{
[JsonPropertyName("project_id")]
public string ProjectId { get; set; }
...
0
голосов
1ответ
18 показов
парсинг нескольких пакетов с контроллерами для создания документации
Встал вопрос о внедрении Swagger 2 в проект, на данный момент контроллеры лежат каждый в своем пакете в общем пакете, выглядит это примерно так
Swagger config имеет вид:
@Bean
public Docket api() {
...
0
голосов
1ответ
36 показов
Как по умолчанию открывать Swagger/index, вместо Index.chtml
При запуске проекта (.Net Core MVC) открывается как обычно Index.chtml . Как по умолчанию открывать интерфейс Swagger для теста методов.
0
голосов
1ответ
68 показов
Swagger, как в интерфейсе поместить свойства объекта в отдельные поля?
Возможно ли в Swagger в интерфейсе поместить свойства объекта в отдельные поля, как указано на скриншоте ниже? Версия Swagger 2.0 или 3.0.
Вот пример того, как нужно сделать:
У меня получается ...
0
голосов
1ответ
38 показов
Валидация модели реквеста
Со сваггера отсылается модель в виде:
{
Bool1 : true,
Bool2 : false,
String1 : "row1",
String2 : row2
}
Два була и два стринга. Проблема в том, что провалидировать на null довольно ...
0
голосов
1ответ
55 показов
Как к swagger 2 добавить http basic аутентификацию
Подскажите, как реализовать, чтобы перед тем, как пользоваться сваггером, он запрашивал авторизацию?
Простое spring boot приложение.