Swagger или Postman?

Вопрос из разрадя холиварных "C# vs Java" или "Samsung vs Apple".

Итак, Swagger vs Postman, как вы считаете?

Давайте я расскажу про обе технологии, а вы уже сами будете делать выводы касательно того что вам использовать.

Для начала скажу что нельзя сказать что что-то лучше, а что-то - хуже. Каждому своё.

Postman - это WebApi клиент, который ранее использовался только расширением хрома, а теперь используется повсеместно. Главной задачей этой технологии является поддержка Rest API Client, но я использовал его только для теста некоторых веб сервисов SOAP. Поддерживает многие механизмы аутентификации, такие как Basic auth, Outh, Outh2, Jwt и тд.

На самом деле это очень мощный стек технологий для тестирования Rest API, вы можете писать свои заголовки, тестировать формы и тд. Это хороший инструмент когда у вас уже есть готовое приложение Rest API и вы хотите протестировать его.

Swagger - это API спецификация с открытым исходным кодом, типа Wsdl для Rest API, которая описывает структуру Rest API. Спецификации основаны на json, и расширение файлов - json или yml.

Это технология с открытым исходным кодом и на данный момент поддерживается достаточно широким кругом поклонников. Последняя версия спецификации третья, аналогичная Open API 3.

Swagger предоставляет множество инструментов:

- Swagger Hub: это облачное решение для поддержки спецификаций API и создания макетов серверов на них.

- Swagger Editor: онлайн GUI редактор для редактирования и утверждения Swagger/Open API сецификаций

- Swagger UI: инструмент для генерации документации из API спецификаций

- Swagger Codegen: библиотеки для генерации моделей, заглушек и клиент SDK на многих языках