4. HTTP 交換 (The HTTP Exchange)

4.1. HTTP リクエスト (The HTTP Request)

DoH クライアントは HTTP GET または POST メソッドと本節のその他の要件を使用して、単一の DNS クエリを HTTP リクエストとしてエンコードします。DoH サーバーは URI テンプレートを使用してリクエストが使用する URI を定義します。

本文書で定義された URI テンプレートは、HTTP メソッドが POST の場合は変数なしで処理されます。HTTP メソッドが GET の場合、単一の変数「dns」が DNS リクエストの内容（第 6 節で説明）として定義され、base64url [RFC4648] エンコーディングを使用します。

DoH サーバーは POST と GET の両方のメソッドを実装しなければなりません (MUST)。

POST メソッドを使用する場合、DNS クエリは HTTP リクエストのメッセージボディとして含まれ、Content-Type リクエストヘッダーフィールドがメッセージのメディアタイプを示します。

DoH クライアントは、応答で理解できるコンテンツタイプを示すために HTTP Accept リクエストヘッダーフィールドを含めるべきです (SHOULD)。

HTTP キャッシュの親和性を最大化するために、DNS メッセージヘッダーの ID フィールドを含むメディアフォーマット（例：「application/dns-message」）を使用する DoH クライアントは、各 DNS リクエストで DNS ID として 0 を使用すべきです (SHOULD)。

4.1.1. HTTP リクエストの例 (HTTP Request Examples)

これらの例は [RFC7540] の HTTP/2 スタイルフォーマットを使用します。

GET メソッドを使用した www.example.com のクエリの例：

:method = GET
:scheme = https
:authority = dnsserver.example.net
:path = /dns-query?dns=AAABAAABAAAAAAAAA3d3dwdleGFtcGxlA2NvbQAAAQAB
accept = application/dns-message

POST メソッドを使用した同じクエリの例：

:method = POST
:scheme = https
:authority = dnsserver.example.net
:path = /dns-query
accept = application/dns-message
content-type = application/dns-message
content-length = 33

<33 bytes represented by the following hex encoding>
00 00 01 00 00 01 00 00  00 00 00 00 03 77 77 77
07 65 78 61 6d 70 6c 65  03 63 6f 6d 00 00 01 00
01

4.2. HTTP レスポンス (The HTTP Response)

本文書で定義された唯一のレスポンスタイプは「application/dns-message」ですが、将来他のレスポンスフォーマットが定義される場合があります。

DoH サーバーは「application/dns-message」リクエストメッセージを処理できなければなりません (MUST)。

DoH サーバーは「application/dns-message」レスポンスを提供できるべきです (SHOULD)。

「application/dns-message」コンテンツタイプを使用する場合、レスポンスメッセージボディには完全な DNS レスポンス（すべてのヘッダーフィールドを含む）が含まれます。DoH サーバーはレスポンスの DNS ヘッダーの「クエリ識別子」(QID) フィールドをゼロに設定しなければなりません (MUST)。DoH クライアントは DNS レスポンスの QID フィールドを無視しなければなりません (MUST)。

4.2.1. DNS と HTTP エラーの処理 (Handling DNS and HTTP Errors)

DNS レスポンスが成功しない場合でも、DoH サーバーは DNS レスポンスとともに HTTP 成功ステータスコード（2xx）を返します。

サーバーがリクエストを解決できない場合、通常 HTTP 4xx エラーを返します。クライアントはこれを DNS SERVFAIL レスポンスとして扱うべきです (SHOULD)。

DoH クライアントは HTTP リダイレクトを処理しなければなりません (MUST)。

4.2.2. HTTP レスポンスの例 (HTTP Response Example)

:status = 200
content-type = application/dns-message
content-length = 64
cache-control = max-age=128

<64 bytes represented by the following hex encoding>
00 00 81 80 00 01 00 01  00 00 00 00 03 77 77 77
07 65 78 61 6d 70 6c 65  03 63 6f 6d 00 00 01 00
01 03 77 77 77 07 65 78  61 6d 70 6c 65 03 63 6f
6d 00 00 01 00 01 00 00  00 80 00 04 5d b8 d8 22

この例の DNS レスポンスは www.example.com の IPv4 アドレスが 93.184.216.34 であり、この情報の TTL が 128 秒であることを示しています。