Раздел 43 · Автотестирование с нуля

JSON, REST и OpenAPI: читаем описание API

junior~25 мин

без входаВойди, чтобы отмечать прогресс, вести заметки и решать задачи в редакторе. войти

Тимур · бэкенд, #qa-antrakt

Ты третий раз спрашиваешь в личке, какие поля у заказа. Всё описано в Swagger, ручка POST /orders. И ещё: в репозитории лежит коллекция Глеба на 80 запросов в Postman. Это не тесты, не опирайся на неё.

Тимур прав в обоих пунктах, хотя звучит резко. Ответы на «какие поля» уже записаны, и записаны точнее, чем он перескажет по памяти. А 80 запросов без единой проверки ничего не проверяют: они только ходят на сервер. В этом уроке научимся читать описание API, отправлять запросы из терминала и отличать черновик от теста.

Меню в ресторане

В ресторане ты не идёшь на кухню спрашивать повара, что он умеет. Ты открываешь меню. Там перечислены блюда, у каждого состав, вес и цена. Хочешь пасту без сыра, а в меню сказано «состав не меняем», значит, официант откажет, и это не грубость, а правило заведения.

Меню полезно и проверяющему. Если в меню написано «300 граммов», а принесли 200, это расхождение видно без спора о вкусах. Меню служит договором между кухней и гостем.

У API тоже есть меню. В нём перечислено, какие запросы можно отправить, что положить в тело и что придёт в ответ. Тестировщику оно даёт главное: ответ на вопрос «а как должно быть?».

урок из курса

Урок из курса «Автотестирование с нуля». Курс покупается один раз и остаётся навсегда: 500 ₽.

Оплата пока не подключена: премиум и курсы открываются промокодом.