Перенаправление

Falcon определяет набор исключений, которые могут быть подняты внутри метода middleware, хука или ответа, чтобы запустить ответ 3xx (Перенаправление) клиенту. Поднятие одного из этих классов прерывает обработку запроса подобно поднятию экземпляра или подкласса HTTPError

Перенаправления

exception falcon.HTTPMovedPermanently(location) [source]

301 Постоянно перемещено.

Код состояния 301 (Постоянно перемещено) указывает, что целевому ресурсу был назначен новый постоянный URI.

Примечание

По историческим причинам пользовательский агент МОЖЕТ изменить метод запроса с POST на GET для последующего запроса. Если это поведение нежелательно, можно использовать код состояния 308 (Постоянное перенаправление).

См. также: https://tools.ietf.org/html/rfc7231#section-6.4.2

Параметры:	location (str) – URI для предоставления в качестве заголовка Location в ответе.

exception falcon.HTTPFound(location) [source]

302 Найдено.

Код состояния 302 (Найдено) указывает, что целевой ресурс временно находится по другому URI. Поскольку перенаправление может время от времени изменяться, клиент должен продолжать использовать эффективный URI запроса для будущих запросов.

Примечание

По историческим причинам пользовательский агент МОЖЕТ изменить метод запроса с POST на GET для последующего запроса. Если это поведение нежелательно, можно использовать код состояния 307 (Временное перенаправление).

См. также: https://tools.ietf.org/html/rfc7231#section-6.4.3

Параметры:	location (str) – URI для предоставления в качестве заголовка Location в ответе.

exception falcon.HTTPSeeOther(location) [source]

303 См. другое.

Код состояния 303 (См. другое) указывает, что сервер перенаправляет пользовательский агент на другой ресурс, как указано в поле заголовка Location, которое предназначено для предоставления косвенного ответа на исходный запрос.

Ответ 303 на запрос GET указывает, что исходный сервер не имеет представления целевого ресурса, которое может быть передано по протоколу HTTP. Однако по Location в ответе можно получить представление для альтернативного ресурса. Получатель может найти эту альтернативу полезной, даже если она не представляет исходный целевой ресурс.

Примечание

Новый URI в поле заголовка Location не считается эквивалентным эффективному URI запроса.

См. также: https://tools.ietf.org/html/rfc7231#section-6.4.4

Параметры:	location (str) – URI для предоставления в качестве заголовка Location в ответе.

exception falcon.HTTPTemporaryRedirect(location) [source]

307 Временное перенаправление.

Код состояния 307 (Временное перенаправление) указывает, что целевой ресурс временно находится по другому URI, и пользовательский агент НЕ ДОЛЖЕН изменять метод запроса, если он выполняет автоматическое перенаправление на этот URI. Поскольку перенаправление может со временем меняться, клиент должен продолжать использовать исходный эффективный URI запроса для будущих запросов.

Примечание

Этот код состояния похож на 302 (Найдено), за исключением того, что он не позволяет изменять метод запроса с POST на GET.

См. также: https://tools.ietf.org/html/rfc7231#section-6.4.7

Параметры:	location (str) – URI для предоставления в качестве заголовка Location в ответе.

exception falcon.HTTPPermanentRedirect(location) [source]

308 Постоянное перенаправление.

Код состояния 308 (Постоянное перенаправление) указывает, что целевому ресурсу был назначен новый постоянный URI.

Примечание

Этот код состояния похож на 301 (Постоянно перемещено), за исключением того, что он не позволяет изменять метод запроса с POST на GET.

См. также: https://tools.ietf.org/html/rfc7238#section-3

Параметры:	location (str) – URI для предоставления в качестве заголовка Location в ответе.