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


В шахматном порядке Swagger V
Или Приготовление колбасы В этом посте я рассмотрю swagger-codegen и swagger-codegen-cli . В частности, я собираюсь внести изменения в код, который генерирует скелет сервера Node.js Swagger Editor . Это потребует изменений как в Java-коде, так и в шаблонах Mustache. Шаблоны Проще говоря, генератор кода Swagger считывает вашу спецификацию API и генерирует внутреннюю модель данных. Эта модель данных используется для заполнения шаблонов, которые могут давать код для различных..
Перенос существующего API с REST на GraphQL
В 2016 году я видел разговоры о GraphQL практически на каждой конференции, посвященной веб-разработке. Об этом написано много постов и статей. Но все это в основном об основах GraphQL или новых функциях и выглядело поверхностно. Поэтому я хотел бы рассказать о моем личном опыте внедрения действительно большой системы на GraphQL. Что не так с REST REST не разделяет вопросы транспорта, безопасности и логики данных. Это приводит к множеству проблем. Рассмотрим некоторые из них. Плохие..
Spring Boot и Swagger — Написание хорошей документации по API
Документация стала проще API-интерфейсы являются одним из ключевых игроков в мире технологий, независимо от того, используются ли они в простом мобильном приложении для интеграции сложных корпоративных систем. Любое приложение может стать платформой, предоставляя методы для улучшения и добавления услуг к существующим продуктам с помощью API. Наличие хорошей документации для этих API имеет решающее значение для их успеха. Документация по API — это технический контент, включающий..
Swagmock - генератор фиктивных данных для Swagger (он же OpenAPI)
Swagger (также известный как OpenAPI) в значительной степени является стандартом де-факто для определения и описания REST API на разных платформах. Swagger превосходно предоставил формат описания API, независимый от производителя и независимый от языка. Спецификация Swagger предлагает стандартное определение, с помощью которого потребитель может понимать удаленную службу и взаимодействовать с ней с минимальным объемом логики реализации. Swagger, также самый популярный в мире..
4 совета, значительно повышающих эффективность разработки Contract First API
Преодоление разработки API от разработки контракта до реализации с использованием более совершенных инструментов и автоматической генерации кода. REST API играет решающую роль в обмене данными между мобильными приложениями и серверными службами, а также в обмене данными между службами. Благодаря мощной программной среде, такой как Java Spring, создание конечных точек API можно выполнить менее чем за 20 строк кода, поскольку платформа заботится об обработке протокола HTTP и..
Вам не нужно писать тесты для вашего веб-API
TLDR; Если вы используете Swagger для разработки своего API, вы можете использовать Dredd для тестирования своего веб-API без написания единого тестового примера. В наши дни TDD/BDD становится довольно популярным, и в Интернете полно сообщений, в которых люди рекомендуют этот стиль. Но если ваш API имеет много конечных точек, он становится довольно громоздким и удваивает вашу работу (хотя в долгосрочной перспективе это окупается). С тех пор, как я начал разрабатывать API с помощью..
7. Включение Swagger
Прежде чем мы продолжим, давайте включим swagger в нашем сервисе, чтобы его тестирование стало проще. Первый шаг — добавить зависимости Springfox. Теперь, когда мы добавили зависимости, нам нужно определить конфигурацию swagger. Большинству наших конечных точек потребуется передать токен в качестве заголовка HTTP, нам нужно настроить нашу конфигурацию swagger, чтобы облегчить это. Мы создаем файл конфигурации swagger, как определено выше. Предложение globalOperationParameters..