426 Upgrade Required ("необходимо обновление")

https://httpcat.ru/426

Это прямая ссылка на изображение со статусом. Вы можете скопировать и использовать её где угодно.

Описание

Код состояния 426 Upgrade означает, что сервер отказывается выполнять запрос с текущей версией протокола и требует, чтобы клиент переключился на другой, указанный в заголовке Upgrade.

Основные характеристики:

Используется для перехода с HTTP/1.1 на другие протоколы, например, WebSocket, HTTP/2, TLS и др.
Сервер сообщает клиенту, какой протокол требуется, и отклоняет текущий запрос
Клиент может повторить запрос, установив соединение с нужной версией

Типичное использование:

GET /stream HTTP/1.1
Host: example.com

HTTP/1.1 426 Upgrade Required
Upgrade: websocket
Content-Type: application/json

{
    "error": "This endpoint requires a WebSocket connection"
}

Особенности заголовков:

Upgrade — обязательный заголовок в ответе, указывает требуемый протокол (например, websocket, TLS/1.3, h2)
Connection: upgrade — часто сопровождает Upgrade

Когда использовать:

Если сервер поддерживает только новый протокол (например, WebSocket вместо HTTP)
При требовании безопасного соединения (например, переход на TLS)
Для API или сервисов потоковой передачи, использующих нестандартные протоколы

Дополнительно:

Код 426 определён в RFC 7231
Клиенты должны уметь корректно обрабатывать этот статус, если работают с серверами, поддерживающими смену протоколов
Не путать с 101 Switching Protocols, который означает успешную смену протокола, тогда как 426 — требование смены

Документация: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/426