Код состояния — это сводка результатов запроса, предоставленная сервером, в форме, позволяющей программе обрабатывать запрос без чтения его тела. Первая цифра обозначает класс: 2xx — успешно, 3xx — поиск в другом месте, 4xx — неверный запрос, 5xx — сбой сервера. Остальные цифры уточняют значение в рамках данного класса.
Клиенты сначала определяют класс, а затем точный код: обрабатывается код 2xx, затем следует код 3xx, код 4xx отправляется обратно тому, кто сформировал запрос, а код 5xx может быть повторен, если запрос был идемпотентным. Затем конкретные коды содержат конкретные инструкции — 401 означает аутентификацию, 429 — замедление, 412 — повторное чтение перед записью.
Тело запроса — это настоящий ответ, а код — лишь украшение. Кэши, прокси, логика повторных попыток, мониторинг и браузеры — все они работают с состоянием запроса, не читая его содержимое; API, возвращающий код 200 с {"error": …}, невидим для всех них, как и частота его ошибок.
Индекс кодов состояния содержит ссылки на отдельные страницы для каждого кода, возвращаемого этой тестовой площадкой, каждая из которых имеет конечные точки для его генерации. Запрос GET /faults/v1/status/{code} возвращает любой код от 200 до 599.
Все термины · Приёмы тестирования · Все 39 mock REST API
Последнее обновление