Перейти к содержанию
IT NOMADКарьера в ITШкола IT NOMAD

Практикум с коллекцией

Тестирование API в Postman: первые запросы и проверки для начинающих

Сервер ответил «200 OK», а данные оказались не теми. Научимся замечать такое расхождение: отправим запросы, проверим ответы и сохраним коллекцию, к которой можно вернуться.

Что получится

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

Около 8 минут чтения и 20–30 минут практики. Нужен установленный Postman с доступом в интернет. Примеры рассчитаны на интерфейс с вкладкой Scripts → Post-response; в старых версиях она может называться Tests. Все данные учебные.

01 / Что проверяем

Почему зелёного «200 OK» недостаточно

Представьте, что форма должна передать направление курса и количество мест. Запрос получил ответ 200 OK, но вместо трёх мест отправил тридцать. Связь с сервером сработала, а нужные данные не переданы. Поэтому в API-тесте проверяют и код ответа, и содержимое относительно ожидаемого результата.

API здесь означает способ обмена данными между программами. Postman позволяет отправить такой запрос напрямую, без кнопки на сайте. Метод задаёт тип действия, URL указывает адрес, а параметры или тело запроса передают данные. Ответ содержит статус, заголовки и, если предусмотрено, тело.

Мы используем публичный учебный сервис Postman Echo. Он возвращает сведения о полученном запросе. Никакого заказа или заявки на курс этот пример не создаёт. Это важно: ответ Echo доказывает передачу данных, но не проверяет бизнес-логику настоящего магазина или школы.

Договоримся об ожидаемом результате до отправки

В первом запросе должны вернуться параметры course=qa и limit=3. Во втором должны вернуться JSON-поля course со строкой qa и seats с числом 3. Эти ожидания зафиксированы в проверках, а не вычисляются из полученного ответа.

02 / Первый запрос

Передайте параметры и найдите их в ответе

  1. Откройте Postman и создайте HTTP-запрос. В разных версиях это кнопка New → HTTP или новая вкладка запроса.
  2. Слева от адресной строки выберите метод GET. Вставьте адрес из блока ниже.
  3. Откройте Params. Должны появиться две строки: course со значением qa и limit со значением 3. Галочки у обеих строк должны быть включены.
  4. Нажмите Send. В области ответа найдите статус 200 и JSON-объект args.
  5. Сохраните запрос в новую коллекцию «IT NOMAD · Первый API» под именем «01 GET параметры».

Адрес первого запроса

https://postman-echo.com/get?course=qa&limit=3

JSON представляет данные в виде полей и значений. В ответе будет больше полей, но для этой задачи важен следующий фрагмент:

{
  "args": {
    "course": "qa",
    "limit": "3"
  }
}

Обратите внимание на кавычки вокруг "3". Параметр адресной строки вернулся как строка. Это не то же самое, что JSON-число 3. Тест, который без объяснения преобразует оба значения в число, может скрыть нежелательное изменение типа данных.

03 / Проверки ответа

Добавьте три проверки и убедитесь, что они могут упасть

Откройте у запроса вкладку Scripts → Post-response и вставьте код. Скрипт выполнится после получения ответа. Затем снова нажмите Send и откройте Test Results. Для исходного запроса ожидаются три успешные проверки.

Три проверки GET-запроса

pm.test("Статус ответа 200", function () {
  pm.response.to.have.status(200);
});

pm.test("Направление курса: qa", function () {
  const body = pm.response.json();
  pm.expect(body.args.course).to.eql("qa");
});

pm.test("Лимит: строка 3", function () {
  const body = pm.response.json();
  pm.expect(body.args.limit).to.eql("3");
});

pm.test() даёт проверке имя и запускает функцию. pm.response.json() читает JSON из ответа, а to.eql() сравнивает фактическое значение с ожидаемым. Здесь строка "3" и число 3 считаются разными значениями. Если сервер вернёт вместо JSON HTML-страницу, проверки с разбором JSON завершатся ошибкой. Это полезный сигнал, который нужно исследовать.

Контрольная поломка

В Params замените значение course с qa на python, не меняя тесты. Отправьте запрос. Статус останется 200, проверка лимита пройдёт, а проверка курса должна упасть. Это ожидаемый результат нашего эксперимента. После проверки верните qa.

Не исправляйте тест на python только ради зелёного результата. Сначала выясните, что изменилось: требование, входные данные или реализация. Хороший тест полезен именно тем, что замечает отличие от зафиксированного ожидания.

04 / Тело запроса

Отправьте число в JSON и отличите его от строки

Создайте второй запрос с методом POST и адресом https://postman-echo.com/post. Откройте Body → raw → JSON. Вставьте тело:

Учебные данные для POST

{
  "course": "qa",
  "seats": 3
}

Проверьте, что запрос отправляется с заголовком Content-Type: application/json. Выбор JSON обычно добавляет его автоматически. Не оставляйте конфликтующий второй Content-Type. У Echo данные вернутся в поле json: нам нужны json.course и json.seats. Для этого учебного endpoint ожидается статус 200, а не 201. Нельзя считать, что любой POST обязан возвращать 201.

Во вкладку Post-response второго запроса вставьте:

Проверки POST-запроса

pm.test("Статус ответа 200", function () {
  pm.response.to.have.status(200);
});
pm.test("Направление курса: qa", function () {
  pm.expect(pm.response.json().json.course).to.eql("qa");
});
pm.test("Количество мест: число 3", function () {
  pm.expect(pm.response.json().json.seats).to.eql(3);
});

Сохраните как «02 POST JSON». Затем замените в теле 3 на "3". Echo вернёт строку, и последняя проверка должна упасть. Этот эксперимент помогает понять, почему визуально одинаковые значения не всегда взаимозаменяемы для программы.

05 / Готовая коллекция

Сохраните запросы, чтобы повторить практику

Коллекция объединяет запросы, настройки и тесты. В нашем файле три запроса: GET с параметрами, POST с JSON и GET на https://postman-echo.com/status/404. Последний специально получает статус 404 и проверяет именно его. Зелёный результат теста означает совпадение с ожиданием, а не обязательно ответ 200.

JSON-файл создаётся на этой странице. Авторизации, ключей и персональных данных в коллекции нет. Запросы обращаются к публичному Postman Echo, поэтому используйте только учебные значения.

  1. Скачайте файл и выберите в Postman Import.
  2. Выберите файл itnomad-first-api.postman_collection.json и завершите импорт.
  3. В Collections откройте «IT NOMAD · Первый API». Убедитесь, что видны три запроса.
  4. Открывайте их по очереди и нажимайте Send. В первом и втором должно пройти по три теста, в третьем один. Всего семь.

Если нет ответа вообще, сначала проверьте доступность сети и адрес. Ошибка DNS, TLS или тайм-аут не равны неуспешной проверке данных. Если пришёл HTML вместо JSON, посмотрите статус и тело: это может быть страница промежуточного сервиса. Не отключайте проверку сертификатов ради зелёного теста.

Облачный учебный сервис может временно не отвечать. Это не ошибка ваших полей. Сохранённая коллекция позволит повторить упражнение позже. Для практики в веб-версии Postman также может потребоваться агент отправки запросов; для первого знакомства проще использовать настольное приложение.

06 / Самостоятельная практика

Проверьте, что изменилось в запросе

Сделайте копию первого GET-запроса. Измените только лимит на 5, сохранив ожидание "3". До отправки запишите: какой статус придёт, какое поле изменится и сколько тестов пройдёт. Затем отправьте запрос и сравните прогноз с результатом.

Ожидаемый результат и объяснение

При нормальной работе Echo ответит 200, args.course останется "qa", а args.limit станет "5". Пройдут две проверки, тест лимита упадёт. Если по новому условию нужен именно лимит 5, обновите ожидаемое значение на строку "5". Если требование осталось прежним, исправлять нужно параметры запроса.

Ещё одна проверка: верните лимит 3, но снимите галочку у параметра course. Тест курса должен упасть, потому что поле не передано. Сравните этот случай с передачей пустого course=: отсутствие поля и пустая строка являются разными входными данными.

07 / Помощь ИИ

Передавайте нейросети условие, а не просьбу «сделай тесты»

Нейросеть может объяснить сообщение об ошибке или предложить дополнительные проверки. Но по одному успешному ответу она не узнает настоящий контракт API. Например, не стоит придумывать обязательное время ответа 200 мс, если такого требования нет.

Промпт для разбора упавшего теста

Помоги разобраться с тестом в Postman.
Учебный сервис: Echo, GET /get.
Отправляю course=qa и limit=5.
Условие теста: args.course равно строке "qa",
args.limit равно строке "3", статус 200.
Фактически: статус 200, args.course="qa", args.limit="5".
Объясни, какая проверка должна упасть и почему.
Отдельно опиши два варианта: требование не менялось;
по новому требованию лимит должен быть 5.
Не исправляй ожидание автоматически и не придумывай SLA.
Предложи ещё один негативный случай с ожидаемым ответом.

В рабочей задаче перед передачей примера удалите токены, cookies, персональные и закрытые данные. Учебных полей из этой статьи достаточно, чтобы понять подход.

Теперь у вас есть коллекция и способ проверить, что тест замечает расхождение. Если ошибка обнаружена в настоящем продукте, её нужно описать так, чтобы другой человек мог повторить запрос. Для этого пригодится пример баг-репорта. Собранную практику можно оформить в портфолио начинающего QA.

АйТи с 0 / IT NOMAD

Больше практики и историй о карьере в IT

В канале «АйТи с 0 | IT NOMAD» делимся информацией о профессиях, кейсами школы и полезными материалами для первых шагов в IT. Присоединяйтесь, чтобы продолжить знакомство со школой.

Перейти в Telegram-канал

Знакомство со школой

Продолжайте развиваться в IT вместе с нами

Узнайте о направлениях обучения и формате работы IT NOMAD.

Познакомиться со школой ↗