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

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 (См. другое) указывает, что сервер перенаправляет пользовательского агента на другой ресурс, как указано в заголовке Location, который предназначен для предоставления косвенного ответа на исходный запрос.

Ответ 303 на запрос GET указывает, что исходный сервер не имеет представления о целевом ресурсе, которое может быть передано по протоколу HTTP. Однако, заголовок 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 ответа.