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

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

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

exception falcon.HTTPMovedPermanently(location, headers=None) [source]

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

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

Примечание

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

(См. также: RFC 7231, Раздел 6.4.2)

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

exception falcon.HTTPFound(location, headers=None) [source]

302 Найдено.

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

Примечание

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

(См. также: RFC 7231, Раздел 6.4.3)

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

exception falcon.HTTPSeeOther(location, headers=None) [source]

303 См. другое.

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

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

Примечание

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

(См. также: RFC 7231, Раздел 6.4.4)

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

exception falcon.HTTPTemporaryRedirect(location, headers=None) [source]

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

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

Примечание

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

(См. также: RFC 7231, Раздел 6.4.7)

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

exception falcon.HTTPPermanentRedirect(location, headers=None) [source]

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

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

Примечание

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

(См. также: RFC 7238, Раздел 3)

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