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

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

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

exception falcon.HTTPMovedPermanently(location) [source]

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

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

Примечание

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

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

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

exception falcon.HTTPFound(location) [source]

302 Найдено.

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

Примечание

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

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

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

exception falcon.HTTPSeeOther(location) [source]

303 См. Другое.

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

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

Примечание

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

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

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

exception falcon.HTTPTemporaryRedirect(location) [source]

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

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

Примечание

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

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

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

exception falcon.HTTPPermanentRedirect(location) [source]

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

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

Примечание

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

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

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