Публикации по теме 'swagger'


Актуальная разработка на основе документации
Как и в случае со многими принципами и методологиями в веб-разработке, от технических, например, JSON API , до нетехнических, например, Методологии бережливого запуска , кажется, что общие принципы или методологии существуют в нескольких вариациях и подсознательно разрабатываются сообществом до того, как появится какая-то блестящая идея. Spark предлагает объединить варианты одним именем, которое впоследствии станет отраслевым стандартом . Это почти верно для разработки, ориентированной..

Стратегия API First - используйте чванство для создания клиента API в виде библиотеки Angular.
Тратьте свое время на действительно важные дела. Например, пишет ваш документ API. Пусть клиент API будет создан с душевным спокойствием. Жизнь перед смертью. Сила перед слабостью. Путешествие перед целью. - Брэндон Сандерсон Мне нравится Архив штормового света. Хотя я надеюсь, что мистер Сандерсон доделает его поскорее. Но я думаю, ожидание - тоже часть удовольствия. Тем не менее, эта цитата имеет некоторое сходство с тем, о чем я собираюсь говорить, с небольшими изменениями...

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

Документация по CXF REST API с использованием Swagger
Согласно руководству Swagger, swagger поддерживает только Джерси (см. https://github.com/wordnik/swagger-core/wiki/java-jax-rs ) Есть ли у кого-нибудь опыт работы с swagger с реализацией CXF JAX-RS ? Не могли бы вы поделиться своими...
5020 просмотров

Описание объекта ответа в API-Explorer/Swagger
Я использую API-Explorer от Restler 3 , который является ответвлением Swagger-UI , и мне интересно, нашел ли кто-нибудь эффективный способ документирования/описания объекта ответа JSON, который возвращает API. Очевидно, что кое-что из этого — в...
1012 просмотров
schedule 22.01.2023

Запрос REST не работает вне Проводника
Я использую Restler API Explorer (форк пользовательского интерфейса Swagger), и когда я тестирую вызов службы, он работает нормально, но когда я вырезаю и вставляю тот же URL-адрес в расширенный клиент REST Chrome, я получаю сообщение об ошибке «403...
189 просмотров
schedule 06.04.2023

ServiceStack Swagger-UI повторяется
Используя SwaggerFeature ServiceStack, я вижу, что все мои маршруты повторяются на странице документации Swagger. Под каждым узлом «/ v1» все мои конечные точки повторяются для каждого «/ v1». Я настроил ServiceStack, как указано на...
387 просмотров
schedule 06.05.2022

Возможность ServiceStack + Swagger по-разному группировать ресурсы
Позвольте мне начать с того, что ServiceStack как фреймворк превзошел все мои ожидания. Удивительно, что удалось сделать. В настоящее время я использую плагин пользовательского интерфейса Swagger с ServiceStack, и мне было интересно, есть ли...
387 просмотров
schedule 25.11.2023

Сборка swagger-codegen в Windows — можно ли использовать Git Bash?
Я пытаюсь собрать swagger-codegen в Windows 7 x64. Я столкнулся с проблемой, когда мне пришлось запустить ./sbt assembly . Я не мог понять, как это сделать из командной строки Windows. Вместо этого я запустил его из Git-Bash. Он запустился...
1460 просмотров
schedule 23.05.2023

Как настроить Swagger в Glassfish 4 без web.xml?
Документация Swagger описывает несколько различных способов настройки Swagger в приложении. К сожалению, все они используют web.xml и полагаются на жесткое кодирование версии API и базового URL-адреса в web.xml. Есть ли способ настроить Swagger...
5268 просмотров
schedule 24.08.2023

swagger-node-express: как загрузить файл из swagger-ui?
Видел этот вопрос и ответ, но не получил таких же результатов, как OP Как публиковать файлы в swagger? Использование этой спецификации в моем API swagger-node-express exports.saveFile = { 'spec' : { "description" : "Saves a file to...
4534 просмотров
schedule 19.10.2023

Формат загрузки и аннотации
Теперь, когда доступен класс UploadFormat, у меня есть один вопрос: Совместим ли формат загрузки с аннотациями Restler? Если да: как его использовать? "@param файл $файл" ? Если нет: значит, я не понимаю смысла этого класса. Как обрабатывать...
118 просмотров
schedule 23.04.2023

Дополнительные параметры с Play 2 и Swagger
Я пытаюсь использовать Swagger для документирования API REST Play 2, но swagger-play2 , похоже, не понимает необязательные параметры, определенные с помощью типа Option Scala - нормальный способ сделать параметр необязательным в Play 2: GET...
3816 просмотров

Интеграция swagger resteasy jboss
Я пытался интегрировать чванство с отдыхом. Я пробовал много реализаций. Реализация, которая работает для меня, приведена ниже. Но я не вижу apis[]. web.xml <?xml version="1.0" encoding="UTF-8"?> <web-app...
3685 просмотров
schedule 21.10.2022

Как выполнить интеграцию сервера swagger без аннотации swagger?
Я могу интегрировать CXF jax-rs с аннотацией swagger(@Api, @ApiOperation, @ApiResponses, @ApiParam) Но хотелось бы интегрироваться без @Api, @ApiOperation, @ApiResponses, @ApiParam. Я просмотрел следующий код:...
2365 просмотров
schedule 26.12.2023

Генерация документации API из Java Cloud Endpoint
Я ищу эффективный способ создания документации API в удобочитаемом формате из сгенерированных файлов из Cloud Endpoint (Java). Сгенерированные файлы: - my_api.api - my_api*.discovery Что-то вроде этого: -...
495 просмотров

Переопределить модель уровня глагола / схему модели в Swagger-UI
Я работаю с swagger-ui, пытаясь стандартизировать документацию по API. Я понял, что для глаголов (GET, PUT, POST и т. Д.), Которые используют параметр тела и, следовательно, должны показывать модель и схему модели, схема определяется на уровне...
1696 просмотров
schedule 15.04.2024

Apigee-127: невозможно выполнить развертывание в Apigee в помещении из Apigee-127, ошибка 303
Я пытаюсь развернуть свой Mock API в Apigee Edge из командной строки Apigee-127. Это экземпляр On-Prem, поэтому у меня есть VPN, который предоставит мне доступ. Однако как только я начну и попытаюсь развернуть API. Я получаю следующую ошибку:...
233 просмотров
schedule 12.05.2024

Исключить модели или свойства из чванливого ответа
Я использовал чванство в своем проекте apache cxf, использовал аннотации @Api, @ApiOperations и @ApiParam и создал api-документ для остальных сервисов. Но я хочу исключить некоторые поля, такие как EntityTag, StatusType и MediaType и т. Д., Из...
68293 просмотров
schedule 16.03.2022

Модель Swagger для массива с именованными элементами
Написание модели swagger для массива json кажется мне довольно простым, например. если бы у меня был этот массив: [ { "name": "dave", "number": 123 }, { "name": "mary", "number": 456 } ] Я бы написал для него...
6866 просмотров
schedule 09.05.2023

Swagger и RESTful весенние ресурсы ненависти
В моем RESTful API все ресурсы расширяют базу ResourceSupport Spring, чтобы гарантировать Принципы по дизайну. Например: public class PoolResource extends ResourceSupport { private String name; ... } Я также использую Swagger, и...
11515 просмотров
schedule 11.12.2022

Как изменить имя API в классе, созданном с помощью swagger-codegen
Я использую swagger-springmvc и swagger-codegen для создания клиентской библиотеки Java для веб-службы RESTful. Я написал собственное расширение BasicJavaGenerator (см. Ниже) для переопределения имен пакетов и могу успешно генерировать файлы...
8776 просмотров
schedule 05.08.2022

Composer не может загрузить форк из пакета
Я изо всех сил пытаюсь загрузить вилку для пакета с композитором. Я пытаюсь интегрировать Swaggervel, пакет Swagger для Laravel 5, в свой проект. В текущем dev-master есть ошибка, которая вызывает несовместимость с laravel 5. НО есть форк на...
965 просмотров
schedule 01.08.2022