サーバー応答 308 Permanent Redirect

HTTP ステータスコード 308 の定義

HTTP ステータスコード 308 (Permanent Redirect) は、リソースが新しい URI に移動したことを示すために使用される固定リダイレクトです。このコードの特異性は、後続のリクエストが新しい URI に対しても元のリクエストメソッド（例えば、POST）を保持することです。

308 ステータスコードの主な違い

301 (Moved Permanently): リソースが長期的に移動したことを示すが、メソッドが GET に変更される。
302 (Found): 一時的なリダイレクトで、メソッドが GET に変更される。
303 (See Other): POST リクエストの後に GET リクエストを促すリダイレクト。

308 ステータスコードの使用シナリオ

クライアントからのデータを保存する際に、元のメソッドを保持したい場合。
API のエンドポイントが変更された場合に、クライアントが元のリクエストメソッドを維持する必要がある場合。
リソースの移動が永久的であることを示す必要がある場合。

実際の使用例

以下に、308 リダイレクトの具体例を示します。

他のドメインへのリダイレクト: 例えば、example.com から new-example.com へデータを POST する場合、308 ステータスコードを使用してリダイレクトします。
ウェブアプリケーションでのデータ保存: ユーザーがフォームを送信する際に、データの保存後にリダイレクトを行い、元のメソッドを保持します。
API におけるリダイレクト: エンドポイントが移動した場合、308 ステータスコードを使用して、クライアントが元のリクエストメソッドを維持できるようにします。

308 ステータスコードに関連するエラー

308 ステータスコードに関連するエラーは、いくつかの原因によって発生します。以下は、その原因とエラーを特定する方法です。

原因: サーバー設定の誤り、誤ったリダイレクト設定、クライアント側の不具合。
エラーの特定: HTTP レスポンスのステータスコードが 308 であることを確認する。

異なるプログラミング言語でのエラー修正

JavaScript (Node.js)


const express = require('express');
const app = express();

app.post('/old-endpoint', (req, res) => {
    res.redirect(308, '/new-endpoint');
});

ここで、元のリクエストメソッドを保持するために、リダイレクトの設定を行います。

Python (Flask)


from flask import Flask, redirect, request

app = Flask(__name__)

@app.route('/old-endpoint', methods=['POST'])
def old_endpoint():
    return redirect('/new-endpoint', code=308)

リダイレクトを行う際に、HTTP メソッドを保持することができます。

PHP


header('Location: /new-endpoint', true, 308);
exit();

PHP でリダイレクトのステータスコードを設定し、適切に処理します。

リダイレクトのテストとデバッグ

リダイレクトを確認するためのツールには、cURL や Postman などがあります。これらのツールを使用して、リダイレクトが正しく機能し、リクエストメソッドが保持されることを確認できます。

308 ステータスコードの使用に関する推奨事項

301 や 302 の代わりに 308 を使用すべき状況を理解する。
アプリケーションでのリダイレクトを実装する際のベストプラクティスを遵守する。

ステータスコード	意味	メソッド保持
308	Permanent Redirect	はい
301	Moved Permanently	いいえ
302	Found	いいえ
303	See Other	いいえ