If-None-Match ヘッダー

HTTP の If-None-Match リクエストヘッダーは、リクエストを条件付きにします。 サーバーは、GET および HEAD メソッドでリクエストされたリソースを、200 ステータスで返します。ただし、そのリソースに If-None-Match ヘッダー内のものと一致する ETag が存在しない場合に限ります。 その他のメソッドについては、最終的に存在するリソースの ETag が、リストされている値のいずれとも一致しない場合にのみ、リクエストが処理されます。

GET および HEAD メソッドにおいて条件が満たされない場合、サーバーは 304 Not Modified を返し、かつ、同じリクエストに対する 200 レスポンスで送信されるはずだったヘッダーフィールド Cache-Control、Content-Location、Date、ETag、Expires、Vary のいずれかを返さなければなりません。 サーバー側で変更を適用するメソッドの場合、条件が満たされなかった際には 412 Precondition Failed が使用されます。

保存されている ETag との比較には弱い比較アルゴリズムが使用されます。つまり、内容が同等であれば、2 つのファイルは同一とみなされます。バイト単位で完全に一致している必要はありません。 たとえば、フッターの作成日付が異なる 2 つのページであっても、同一とみなされます。

If-Modified-Since と一緒に使用した場合、If-None-Match が優先されます (サーバーが対応している場合)。

リクエストで If-None-Match を使用する一般的なケースは、次の 2 つがあります。

• GET および HEAD メソッドの場合は、関連付けられた ETag を持つキャッシュされたエンティティを更新するため。
• 他のメソッド、特に PUT の場合、 If-None-Match は * 値と共に使用され、存在するかどうか分かっていないファイルを保存する際に、以前他のアップロードが行われておらず、以前 PUT されたデータを失わないことを保証するために使用することができます。この問題は、 lost update problem の一種です。