Описание тега openapi

Описание тега Вопросы с тегом
Спецификация OpenAPI, первоначально известная как спецификация Swagger, - это спецификация машиночитаемых файлов интерфейса для описания, создания, использования и визуализации веб-сервисов RESTful.
0 ответов

Перевод входных значений HTML в файл спецификации Swagger/OpenAPI

Я знаю, что есть несколько способов конвертировать файл спецификации Swagger в файл HTML, но мне было интересно, есть ли способ сделать это наоборот? Скажем, у вас есть пара полей ввода HTML, например, так: <input type="text" name="title"> &lt…
30 май '18 в 23:25
1 ответ

Обеспечивают ли IBM Bluemix и Azure равную поддержку API Blueprint и OpenAPI? Для описания API

Я мог бы помочь, решив, какой язык описания API использовать для API, которые наша команда развернула в IBM Cloud и, возможно, Azure в будущем. Мы неофициально использовали API Blueprint, но при регистрации API в Bluemix я заметил, что (и Azure) уже…
11 апр '18 в 22:13
0 ответов

Игнорирование определенных параметров в проекте Swagger Open API-dropwizard

Я пытался добавить фильтр в мой существующий код API. Я использовал стандартный метод переопределения класса SwaggerSpecFilter и на основе проверки параметров я смог отфильтровать те параметры, которые я не хочу использовать. Теперь требование состо…
06 июл '18 в 06:11
1 ответ

Документация API с Swagger

У меня есть проект на symfony4 с api-платформой. Процесс входа в систему описан в security.yaml вот оно: security: encoders: App\Entity\User: bcrypt providers: our_db_provider: entity: class: App\Entity\User property: email firewalls: .... login: pa…
11 окт '18 в 15:15
2 ответа

Конвертация спецификаций xml в swagger 2.0 с использованием golang

У меня возникли проблемы с преобразованием XML (WSDL) в спецификации Swagger 2.0 в golang. я нашел на github библиотеку, которая конвертирует xml в обычный json, но мне нужно конвертировать в swagger 2.0 json. предложите мне библиотеки, если таковые…
08 сен '17 в 13:49
1 ответ

Swagger Codegen (с плагином maven) для OpenAPI 3.0

Я хочу использовать Swagger Codegen для файла YAML OpenAPI 3.0. И я вижу, что Swagger Codegen 3.0.0-rc0 доступен. Но когда я пытаюсь использовать это, я сталкиваюсь с проблемами. Ниже приведены подробности: мой pom.xml файл с плагином swagger-codege…
02 апр '18 в 18:18
3 ответа

Создайте отклик API-интерфейса swagger/open с массивом неназванных объектов

Я получаю ответ от http-запроса в следующей форме: это массив безымянных массивов и объектов. Я не могу понять правильную спецификацию Swagger (Open API) для этого случая. [ [ { "prop1": "hello", "prop2": "hello again" }, { "prop1": "bye", "prop2": …
11 дек '17 в 06:32
0 ответов

Модель базы данных и методология api-first (openapi) с JHipster и Java Spring

Я пытаюсь изучить и использовать методологию API-первых с JHipster в Java и Spring. До сих пор я генерировал файл yaml, описывающий мой API в спецификации OpenAPI 3.0, затем я генерировал Java-классы, такие как контроллеры и делегаты, для реализации…
16 янв '19 в 09:48
0 ответов

Swagger не отображает свойства объекта в пользовательском интерфейсе

Я делаю документацию для API.На данный момент у меня есть: /script/update: post: tags: - "Script" summary: Update a script operationId: updateScript responses: '200': description: OK "404": description: Not Found requestBody: description: A script o…
18 сен '18 в 11:06
0 ответов

Название модели не отображается при обращении к другим моделям на экране моделей openapi 3.0 swagger.

Пожалуйста, посмотрите на изображение выше. В editor.swagger.io в модели Pet, которая содержит массив моделей Tag со свойством, называемым тегами, если свойство тегов расширяется с помощью пользовательского интерфейса, отображается имя модели Tags.…
11 дек '18 в 02:51
1 ответ

Создание таблиц в OpenAPI 3 через Commonmark

В Swagger/OpenAPI 2 я использовал таблицы Markdown, что-то вроде этого: | A | B | C | |---|---|---| | T | F | F | | T | F | T | Но после обновления до OpenAPI 3, где вместо Markdown со вкусом Github используется Commonmark, кажется, что таблицы боль…
07 ноя '17 в 20:12
1 ответ

Выскабливание в python для использования открытого API

Я хочу очистить "www.naver.com", поэтому я попытался очистить с помощью открытого API, я написал следующий код: import urllib.request import urllib.parse from bs4 import BeautifulSoup defaultURL = 'http://openapi.naver.com/search?&' key = 'key=k…
17 май '16 в 13:12
0 ответов

kumuluz-OpenAPI(swaggerUI)

Я ищу способ изменить пример значений тела запроса в Swagger UI. У меня сейчас @ApiResponse( responseCode = "201", description = "Group created", content = @Content(schema = @Schema(implementation = GroupDTO.class)) ), который в свою очередь создает…
15 ноя '18 в 13:52
2 ответа

Ошибка при развертывании конечной точки, содержащей параметр типа "файл"

Я пытаюсь развернуть простую конечную точку, которая содержит параметр типа file, Я использую gcloud service-management deploy команда со следующим openam-совместимым yaml: swagger: "2.0" info: description: "Image API" title: "Image API" version: "v…
28 мар '17 в 01:50
1 ответ

Как определить в API, с какой версии поддерживается путь / параметр

У нас есть растущий swagger API/openAPI и для документирования изменений, которые мы хотели бы документировать по пути или параметру (и, возможно, определению), начиная с какой версии API он доступен. Спецификация чванства знает info.version поле, н…
23 июн '16 в 12:05
1 ответ

Как создать секреты с помощью Python-клиента Kubernetes?

Я пытался поиграть с созданием секретов для кластера Kubernetes с помощью клиента Python. Я получаю ошибку, которая говорит Traceback (most recent call last): File "create_secrets.py", line 19, in <module> api_response = v1.create_namespaced_s…
16 окт '17 в 04:50
1 ответ

OpenAPI повторно использует часть определения без определения новой

Предположим, что у меня есть это определение в определении yaml OpenApi definitions: User: description: "User" type: "object" properties: firstname: type: "string" lastname: type: "string" password: type: "string" email: type: "string" username: typ…
17 окт '17 в 05:55
1 ответ

Как мне получить aiohttp-swagger для распознавания переменных запроса GET?

Я хотел бы использовать aiohttp-swagger в моем проекте Python, но я не могу понять, как он обрабатывает переменные полезной нагрузки GET URL и POST. У меня есть этот пример кода на основе примера быстрого запуска здесь. Единственное изменение, котор…
26 июл '18 в 16:01
1 ответ

Как создать несколько моделей для Java с OpenApi Generator?

Я успешно сгенерировал REST-клиент в Java из Swagger/OpenApi v2.0 с помощью OpenApi Generator CLI 3.3.2-SNAPSHOT Но у меня уже есть клиент REST, поэтому я просто хочу сгенерировать некоторые модели из спецификации. Я получаю успех, когда я бегу: jav…
23 окт '18 в 22:21
0 ответов

openapi-generator - как получить скомпилированный вывод для всего параметра requestBody

Я использовал openapi-генератор с шаблонами typcript-jquery. Некоторые из моих методов API - просто быстрые определения некоторых существующих функций, и поэтому requestBody определяется как плохо определенный объект: requestBody: required: true con…
27 ноя '18 в 11:58