CheckcraftЧек-лист тестирования REST API на примере заказа
Запрос выполнился без ошибки, но это ещё не законченная проверка. Чтобы повторять тест после изменений, каждому действию нужен ожидаемый результат. Разберём учебный ответ заказа и границы такой проверки.
Зафиксировать договорённость до запуска
Для учебного сценария считаем, что GET возвращает существующий оплаченный заказ. По требованиям ожидаем HTTP 200, status равный PAID, число itemCount равное двум и сумму 2000. Это условия упражнения, а не универсальный контракт всех API.
{"orderId":"ORD-1042","status":"PAID","itemCount":2,"items":[{"amount":1200},{"amount":800}],"total":2000}Проверить сам запрос
Сверьте метод, адрес окружения, путь и параметры. При наличии тела запроса проверьте Content-Type. Для запроса с авторизацией используйте тестового пользователя с известными правами. Сохраните исходные данные, чтобы при повторном запуске сравнивать поведение в одинаковых условиях.
Проверить поля ответа
Ожидайте orderId нужного заказа и status PAID. Значение itemCount должно быть числом, а не строкой "2". Решите по контракту, допустимы ли null, отсутствие поля и дополнительные поля. Если эти состояния имеют разный смысл, заведите отдельные проверки. Проверка типов JSON и проверка обязательных полей помогают повторить это на данных.
Проверить массив и расчёт
В учебном ответе массив items содержит две позиции. Сумма amount равна 1200 + 800, поэтому total ожидается 2000. Количество элементов и сумма проверяются независимо. Для API со скидкой или округлением сначала уточните формулу и правила точности. Готовые сценарии есть для массива JSON и расчётов в API.
Проверить отказ и повторное действие
На тестовом окружении повторите запрос без токена, с правами другого тестового пользователя и с неизвестным идентификатором. Ожидаемый статус каждого случая определяет контракт. Для создающего POST отдельно проверьте поведение повторной отправки, особенно если API поддерживает ключ идемпотентности. Не используйте рабочие платежи для упражнения. Негативные сценарии удобно хранить отдельно от успешного.
Сохранить результат, который можно воспроизвести
Сохраните запрос, входные данные, правила и отчёт. Перед автоматизацией измените одно поле учебного ответа и проверьте, что тест становится красным. В Checkcraft можно начать с готового тест-кейса без кода, затем повторять тот же набор после изменений. Такой набор покрывает выбранную бизнес-операцию, но не заменяет нагрузочное тестирование или аудит безопасности.