308 Permanent Redirect ("постоянное перенаправление")

https://httpcat.ru/308

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

Описание

Код состояния 308 Permanent Redirect означает, что запрашиваемый ресурс был навсегда перемещён на новый URL, и клиент должен использовать тот же метод и тело при повторном запросе.

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

Постоянное перенаправление (как 301), но с сохранением метода (как 307)
Метод запроса (например, POST, PUT) и тело **не должны изменяться**
Клиенты должны обновить закладки и кеши, используя новый URL

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

PUT /old-resource HTTP/1.1
Host: example.com
Content-Type: application/json

{
  "name": "example"
}

HTTP/1.1 308 Permanent Redirect
Location: https://api.example.com/new-resource

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

Location — обязательно, содержит новый постоянный URL ресурса
Cache-Control — может управлять кэшированием перенаправления

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

Если ресурс навсегда переехал и важно сохранить метод запроса
В REST API при изменении структуры URL, особенно для POST, PUT, DELETE
В сценариях, где нельзя допустить автоматическое изменение POST на GET

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

Является современным и более предсказуемым аналогом 301 Moved Permanently
Поддерживается большинством современных браузеров и HTTP-клиентов
Если метод можно изменить на GET, подойдёт 303 See Other

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