Инструменты и для Создания .NET HTTP API. Продолжение
Начало
Инструменты разработки и тестирования HTTP API.
HttpRepl
HttpRepl это глобальный инструмент .NET CLI, который предоставляет способ просмотра API, описанного спецификацией OpenAPI, в виде каталога. После установки вы можете использовать команду
httprepl -o <openapi-url>, чтобы подключиться к любому проекту веб-API, описанному по OpenAPI, и изучить его, используя знакомые команды, такие как ls или dir, и перемещаться по структуре API так же, как по дереву каталогов.Если вы еще не пробовали HttpRepl, ознакомьтесь с документацией для получения дополнительной информации о различных командах, которые он предлагает. В документации также показано, как настроить HttpRepl в качестве «браузера», чтобы он открывался при запуске отладчика, если вам удобнее работать с терминалом.
REST Client для Visual Studio Code
Есть несколько впечатляющих инструментов, которые поставляются как расширения для Visual Studio Code. Один из них, REST Client, предлагает тестирование запросов HTTP API внутри IDE. Создав файл .http, содержащий ваши тестовые запросы, вы можете запустить REST Client и отправлять эти запросы по отдельности, просматривая результаты в новом окне.
Postman
Конечно, нельзя не упомянуть один из самых популярных инструментов тестирования HTTP-запросов в целом и REST API в частности – Postman. Это отдельное приложение с богатым набором функций осуществления и автоматического тестирования HTTP-запросов (например, можно проверять код ответа или наличие в результате нужных данных). Также возможно сохранять запросы в коллекции или плейлисты тестирования.
Network Console
В Edge DevTools недавно включили экспериментальную функцию под названием Network Console. Она предлагает пользователям Edge функции тестирования HTTP API в браузере. Чтобы попробовать её, сначала нужно включить Network Console в экспериментальных функциях Edge DevTools (DevTools Settings > Experiments > Enable Network Console).
После этого на вкладке Network вы сможете щелкнуть правой кнопкой мыши на любом ранее сделанном HTTP-запросе и выбрать пункт меню «Изменить и повторно отправить» (Edit and Resend). Откроется инструмент тестирования HTTP запросов прямо в браузере.
Редактор OpenAPI
Редактирование или создание документов OpenAPI вручную может быть сложной задачей. Расширение для VS Code OpenAPI Editor поможет в этом. Оно включает такие функции, как:
- Предпросмотр для SwaggerUI и ReDoc
- IntelliSense для редактирования содержимого JSON/YAML в спецификации OpenAPI,
- Навигацию в виде раскрывающегося списка. Её можно использовать, чтобы найти отдельную операцию в спецификации, вместо того чтобы пролистывать огромный файл JSON.
Окончание следует…
Источник: https://devblogs.microsoft.com/aspnet/open-source-http-api-packages-and-tools/