Найти в Дзене
451 подписчик

Что такое Swagger?


Swagger — это набор инструментов для описания и документирования REST API. В основе лежит спецификация OpenAPI: файл в формате JSON или YAML, где перечислены все эндпоинты, их параметры, тела запросов и возможные ответы с кодами.

Чаще всего тестировщик видит Swagger UI — веб-страницу, которая строится из этого файла. На ней видно, какие методы есть в API, какие поля обязательны и что сервер вернёт в ответ. Публичный пример можно открыть на petstore.swagger.io.

Главная польза для тестирования — кнопка Try it out. Можно заполнить параметры, нажать Execute и сразу получить ответ сервера, без Postman и без кода. Так удобно изучать новый API и проверять, что ответ совпадает с описанием: те же поля, типы и коды статуса.

Спецификацию OpenAPI можно импортировать в Postman и получить готовую коллекцию запросов. На собеседовании часто спрашивают, чем Swagger отличается от OpenAPI: OpenAPI — это стандарт описания API, а Swagger — инструменты, которые с ним работают.

 Еще у меня есть курсы для QA: qaway.ru/...ses
Что такое Swagger?  Swagger — это набор инструментов для описания и документирования REST API.
Около минуты