Вопросы по теме 'openapi'
Как определить перечисление в OpenAPI (Swagger)?
Кто-нибудь знает, как определить возможные значения «перечисления» в определении OpenAPI 2.0, чтобы они отображались на вкладке «Модель» пользовательского интерфейса Swagger? Пример здесь: https://petstore.swagger.io/#!/pet/addPet имеет параметр...
90393 просмотров
schedule
15.04.2022
Как рекурсивно сослаться на определение включающего типа в OpenAPI / Swagger?
Я пишу определение OpenAPI в редакторе Swagger.
Одно из моих определений типа содержит массив, содержащий дочерние элементы того же типа, что и родительский. Т.е. что-то вроде этого:
definitions:
TreeNode:
type: object
properties:...
9281 просмотров
schedule
30.01.2023
В swagger 2.0 (openapi), как иметь другое определение ресурса между запросами POST и PUT?
Если мы посмотрим на API сообщений (например), я хочу, чтобы он мог
создать сообщение
получить сообщение
обновить сообщение
Сообщение содержит внешнюю ссылку (уникальный идентификатор от потребителя)
Этот external_id должен быть...
1271 просмотров
schedule
09.12.2022
Шаблон данных теста Swagger Codegen JMeter
Я генерирую jmx-файл Jmeter из определения swagger, генерируемый JMX и тестовые данные CSV кажутся довольно бесполезными, у него нет информации о параметрах относительно того, что ожидал API, нет кода состояния http для информации сопоставления...
6694 просмотров
schedule
27.09.2022
Как добавить спецификацию Swagger OpenAPI в проект весенней загрузки?
Я нашел этот проект https://github.com/OAI/OpenAPI-Specification Как я понял мы можем писать документацию в .json/.yml файлах. Кроме того, я вижу в http://editor.swagger.io/ , что он может быть отображен в .html файл.
У меня вопрос - как...
3294 просмотров
schedule
09.06.2023
Развернутое приложение Google Endpoints Quickstart выдает сообщение об ошибке, когда я запрашиваю URL-адрес?
Я следую краткому руководству для Cloud Endpoints Frameworks в App Engine в стандартной среде. Я развернул образец API. Когда я открываю https://[my-project].appspot.com/ , я получаю сообщение об ошибке:
Error: Not Found. The Requested URL /...
577 просмотров
schedule
03.03.2022
Swagger: как получить отформатированный пример json
Я действительно изо всех сил пытаюсь понять формат раздела examples ответа. У меня есть следующий ответ, определенный для ошибки 500 Internal Sever.
500InternalServerError:
description: The server encountered an unexpected condition which...
1282 просмотров
schedule
28.06.2023
Как указать примеры для параметров GET в Swagger?
Я использую интерактивный редактор Swagger , чтобы создать спецификацию Swagger для моего API.
В моем API есть одна конечная точка запроса GET, и я использую следующий код YAML для описания входных параметров:
paths:
/fooBar:
get:...
18465 просмотров
schedule
28.12.2022
Как отправить объект JSON как часть составного запроса в редакторе Swagger?
Я пишу документацию по API с помощью редактора Swagger, но у меня проблема с многостраничным запросом POST, содержащим объект JSON. Вот мой YAML-файл Swagger:
swagger: '2.0'
info:
version: 1.0.0
title: Documentation API
paths:
/agent:...
9676 просмотров
schedule
10.01.2023
когда WSO2 API Management начнет поддерживать OpenAPI3.0 (Swagger 3.0)?
Поскольку OpenAPI выпустил новую версию 3.0, а wso2 предоставляет редактор swagger и пользовательский интерфейс (версия 2.0). есть ли время, когда wso2 начинает поддерживать открытый api (swagger) 3.0
584 просмотров
schedule
31.01.2024
Как вернуть массив объектов в SwaggerHub?
Я определяю спецификацию API в SwaggerHub, используя OpenAPI 2.0. Запрос /contacts возвращает массив контактов. Определение приведено ниже:
/contacts:
get:
tags:
- contacts
summary: Get all the contacts...
16039 просмотров
schedule
18.12.2022
Создать спецификацию Swagger / OpenAPI из исходного кода scala (http4s)
Так что я не эксперт по чванству, но все системы, использующие чванство, требуют, чтобы у вас была спецификация чванства в JSON или YAML, определяющая все конечные точки (и т. Д.) Вашего API.
Мой вопрос: есть ли способы сгенерировать эти файлы...
2448 просмотров
schedule
06.02.2023
Как добавить несколько значений в качестве примера в свойствах чванства?
Я использую инструмент Swagger OpenAPI Specification, у меня есть свойство массива строк в одном из следующих определений:
cities:
type: array
items:
type: string
example: "Pune"
Мой API создает результат...
8340 просмотров
schedule
06.12.2022
Переход от структур к OpenAPI к генерации JSONSchema автоматически
У меня есть структура Go, для которой я хочу автоматически сгенерировать схему OpenAPI. Как только у меня есть определение этой структуры в OpenAPI, я хочу сгенерировать ее JSONSchema, чтобы я мог проверить входные данные, которые поступают и будут...
2578 просмотров
schedule
20.04.2022
Как определить параметры в квадратных скобках в OpenAPI (Swagger)?
У меня есть конечная точка с параметрами запроса, в которых используются квадратные скобки:
GET /info?sort[name]=1&sort[age]=-1
Здесь name и age - имена полей из моего определения модели.
Как я могу написать определение OpenAPI...
4004 просмотров
schedule
07.02.2023
Дополнительные свойства не допускаются: чванство, допускающее значение NULL
Я использую swagger 2.0 с node.js express 4.12.3 и mysql db.
Я создал следующую схему -
Country:
type: "object"
properties:
id:
type: "integer"
readOnly: true
description: "Country Id"
country:...
2901 просмотров
schedule
21.02.2023
Библиотека проверки Node.js OpenAPI 3
Мне еще предстоит увидеть какие-либо библиотеки, поддерживающие проверку запросов OpenAPI. Или в этом отношении любые проекты, которые находятся в активной разработке, таковыми являются.
Очень хотелось бы написать в моих микросервисах...
1785 просмотров
schedule
29.12.2022
Отсутствует поле ключа подписки в соединителе Swagger API (через Azure API Management) в приложении логики
Я создал REST API со спецификацией Swagger / OPEN API, который я хотел бы использовать через клиент управления API Azure в приложении логики.
Когда я скачиваю спецификацию, она выглядит так:
{
"swagger": "2.0",
"info": {
"title":...
720 просмотров
schedule
26.12.2023
Как определить параметр, принимающий массив произвольных объектов в OpenAPI (Swagger)?
Можно ли в моей спецификации OpenAPI определить параметр как объект без необходимости определять его свойства (анонимный объект)? В частности, я хочу, чтобы мой API мог принимать массив этих анонимных объектов.
Вот что у меня есть, но я получаю...
1448 просмотров
schedule
24.12.2022
Разверните конфигурацию Openapi YAML в конечной точке Google с помощью $ ref
Можно ли развернуть конфигурацию Openapi YAML на конечных точках Google, если она ссылается на несколько файлов, причем файлы хранятся в структуре папок?
Например:
-\ openapi.yaml
--\service1\service1.yaml
--\service2\service2.yaml
.
.
....
156 просмотров
schedule
24.03.2023
