Swagger
Swagger - это открытый стандарт (OpenAPI) для описания, документирования и тестирования веб-API. Он позволяет разработчикам легко создавать документацию для своих API, а тестировщикам и аналитикам проверять работоспособность API.
В стандартный функционал Swagger входит: отправка запросов, просмотр ответов, возможность посмотреть готовые примеры запросов и ответов, варианты авторизации, возможность экспорта ответа в файл и генерация cURL запроса.
Преимущества
Это, как правило, полностью готовые инструменты, в которых уже созданы все обращения к эндпойнтам, тела запросов и другие параметры.
Они очень быстры и просты в освоении и использовании из-за элементарного функционала.
Содержат примеры ответов и описание приходящих в них параметров.
Не требуют установки на устройство пользователя, они уже развернуты на стенде.
Генерируют cURL, который можно приложить к баг-репорту, чтобы разработчик мог быстрее воспроизвести баг и исправить его.
Недостатки
Они хранят только заранее прописанные разработчиком параметры запросов, которые могут быть избыточными или наоборот, неполными.
Нельзя сохранять свои параметры запросов. То есть после обновления страницы сваггероподобной системы пропадет все, что вы туда ввели. Таким образом, параметры запросов, использующиеся в тест-кейсах, придется хранить в отдельных документах, а это неудобно.
Нельзя создавать коллекции запросов, так как невозможно сохранять свои варианты запросов.
Нельзя создавать скрипты-проверки, ожидаемый результат с фактическим придется сверять глазами/руками.
Невозможны прогоны, то есть автоматизированный последовательный запуск запросов.
Нельзя создавать и использовать никакие окружения, переменные.
Полезность описаний в сваггероподобных системах очень разнится от проекта к проекту.
Когда использовать
Так как это не инструмент тестирования, а интерактивная документация по API, такие системы чаще используются для ознакомления с эндпойнтами и исследовательских проверок.
Источник:
Last updated
