HTTP

どのようなものか

HTTP（Hypertext Transfer
Protocol）は、ブラウザー、アプリ、スクリプトが、サーバーに何かを求め
て返答を受け取るための規則です。その会話を暗号化したTLS接続の中で行
うと、同じプロトコルをHTTPSと呼びます。やり取りは、二つの部分からな
ります。クライアントは、`GET`や`POST`などのメソッド、求める対象、
ヘッダーフィールドの一覧、ときには本文を、要求として送ります。サー
バーは、三桁の状態コード、自分側のヘッダーフィールド、通常は本文で応
答します。ページの読み込み、画像の取得、プログラムから別のプログラム
への呼び出しは、すべて、このやり取りの繰り返しです。

```http
GET /pricing/ HTTP/1.1
Host: example.com
Accept: text/html

HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8
Cache-Control: max-age=600
```

仕様は、これをステートレスと呼びます。各要求には、サーバーが理解する
ために必要なものをすべて含める必要があり、プロトコルは、やり取りの間
の記憶を持ちません。ログイン、買い物かご、セッションは、その上に、通
常はCookieを使って組み立てます。サーバーが一度設定したヘッダーフィー
ルドを、クライアントが後の要求のたびに送り返します。

語彙は少なく、正確です。`GET`と`HEAD`は安全とされます。表現を求め、
何も変更しないと期待される意味です。`PUT`と`DELETE`は冪等です。同じ
ものを二回送っても、一回送った場合とサーバーの状態が同じになります。
`POST`は、どちらも約束しません。状態コードは先頭の桁で分類され、2xx
が成功、3xxが転送、4xxが要求側の問題、5xxがサーバー側の問題です。ク
ライアントは、知らないコードでも、おおよそ何が起きたかを把握できま
す。

通信上の形式が二回置き換わっても、その意味は変わっていません。HTTP/
1.1は、TCP接続上でメッセージをテキストの行として書き、各接続では、一
つずつ順番に応答を返します。HTTP/2は、同じメソッドやフィールドを保ち
つつ、バイナリーのフレームへ収め、一つの接続で多数の要求を交互に流し
ます。HTTP/3は、同じ意味をQUIC上で実現します。QUICはUDP上に構築され
た転送方式で、独立したストリームの間では、TCPのトランスポート層にあ
る先頭ブロッキング（head-of-line
blocking）を避けられます。2022年からIETFは、意味を一つの文書、各版の
通信形式を別々の文書で公開しています。そのため、「404は何を意味する
か」と「バイトをどう並べるか」には、今は別々の答えがあります。

したがってHTTPとHTTPSの比較は、二つのプロトコルの対決ではありませ
ん。HTTPSは、下にTLSを敷いたHTTPで、やり取りを暗号化し、サーバー名を
証明します。WebSocketは、HTTP要求として始まり、その後、接続を双方向
の通信路へ切り替えます。gRPCは、HTTP/2上で動く、遠隔の関数を呼び出す
ための規約です。

なぜ重要なのか

インターネット越しに別のシステムと話すシステムのほぼすべてが、すでに
HTTPを使っています。そのため、重要な決定が、使うかどうかになることは
ほとんどありません。定義された機能を使うか、単なる通信路として使って
残りを自作するかです。

十分に活用すると効果があるのは、長い処理経路を構成するソフトウェア
が、すでにその語彙を理解するからです。クライアントライブラリーは、時
間切れになった`GET`を再試行する場合があります。`POST`は再試行しては
ならず、途中のプロキシーも同じです。キャッシュは、`max-age=600`と記
された応答を十分間保存し、サーバーへ問い合わせずに、次の読者へ渡せま
す。監視は、指示されなくても5xxの応答をエラーと数えます。すべての呼
び出しを、一つのアドレスへの`POST`で送り、失敗を200の応答内で報告す
るAPIは、それらをすべて捨て、どのクライアントにも、そのAPI独自の規則
を覚えさせます。

このモデルにも限界があります。要求と応答は、欲しいものが分かっている
クライアントには適しますが、新しい情報を送り出したいサーバーには、あ
まり適しません。そのため、リアルタイムの更新には、通常、WebSocket、
サーバー送信イベント（server-sent
events）、ポーリングを使います。

公開インターネット上の平文HTTPは、別の問いで、答えは短いものです。ブ
ラウザーが安全でないと表示し、経路上の誰もが読み取って変更でき、証明
書は無料なので、公開通信にはHTTPSを使います。HTTP/1.1、HTTP/2、HTTP/
3の選択は、ほぼサーバーか、その前段のエッジの設定です。どの要求も意
味が同じであるため、アプリケーションコードは変わりません。

実際の活用例

このサイトで最も明確な例は、HTTP自身の構造に沿ったフレームワークへ移
したAPIです。HTTP APIをFiberからHuma
v2へ移行しました。HumaはFiberの上で動き、各エンドポイントを入出力の
構造体で宣言し、手書きの検査ではなく、型の宣言から検証を生成します。
同じ宣言からOpenAPI記述を生成し、CIの検査で、サーバーが登録する経路
と、記述に掲載する経路を比較します。649パス、760操作で一致率は100%で
す。誰も記述していない経路があればビルドが失敗するため、それを保って
います。Fiberを直接使うまま残したエンドポイントは、ちょうど二つで
す。Humaの要求と応答のモデルに適さない、WebSocketのものです。

サイト自身は、コンテンツネゴシエーションを使います。すべてのページを
HTMLとMarkdownで公開し、Markdownを得る一つの方法は、`Accept:
text/markdown`を付けた要求を送り、サーバーに選ばせることです。同じ
ページのonionアドレスが平文の`http://`なのは、意図的です。そのアドレ
スにサービスの公開鍵が符号化されているため、最初のHTTP要求が流れるま
でに、Torがすでに通信路を認証し、暗号化しています。

HTTPは、インフラコードの道具としても登場します。二台目のサーバーを用
意したとき、両事業者のファイアウォールを、それぞれのREST
APIへ直接要求して設定しました。事業者別のコレクションの代わりに、汎
用HTTPタスクを使いました。依存関係と、そのバージョンのずれをなくした
一方、各要求の形は手で書く必要が生じました。事例は、さらにもう一つの
負担を挙げます。汎用HTTPタスクはチェックモードへの対応を宣言していな
いため、マシンを作るプレイの試行実行では、その中のすべてのタスクが省
略されます。そのため、予行演習は、代わりにファイアウォールのプレイで
行います。

問題が起きるところ

HTTPの不具合の大半は、その語彙のある言葉を、途中のほかのソフトウェア
が受け取る意味と違う意味で使うことから起きます。

成功として届くエラー

APIが200を返し、本文へ`"error": "card
declined"`を入れます。キャッシュが保存する場合があります。ダッシュ
ボードは成功と数え、クライアントの再試行処理は動きません。適切な4xx
か5xxの状態コードを送り、本文で問題を説明します。RFC
9457は、そのためのJSONの形を定め、`application/problem+json`として提
供します。

何かを削除するリンク

メール内の登録解除や削除のリンクなど、`GET`要求が状態を変更します。
クローラー、チャットアプリのリンクプレビュー、セキュリティスキャ
ナー、ブラウザーの先読みは、どれも自らリンクをたどり、それぞれがその
処理を実行させる可能性があります。データを変える処理には、`POST`、
`PUT`、`DELETE`のいずれかを使い、リンクが必要なら、確認ページを設け
ます。

二回引き落とされる支払い

クライアントが`POST`を送り、応答が届く前に接続が切れて、再試行しま
す。サーバーは、すでに一回目を処理していました。HTTPは、クライアント
に、それらの場合を区別する方法を与えないため、APIが対処します。ヘッ
ダーで冪等性キーを受け取り、同じキーには保存した結果を返すか、クライ
アントが新しいリソースの識別子を選び、`PUT`で作成するようにします。

GETへ変わるフォーム

サーバーが`POST`へ301か302を返し、別の場所へ転送します。歴史的な理由
から、仕様は、この二つのコードで、ユーザーエージェントがメソッドを
`GET`へ変えることを認め、多くがそうします。そのため、途中で本文が失
われます。転送後もメソッドを保つ必要があるときは、307か308を使いま
す。

キャッシュから届く、違う版

一つのURLが、要求ヘッダーフィールドに応じて、HTMLかMarkdown、英語か
デンマーク語を提供します。何も伝えられていないキャッシュは、最初に見
た版を保存し、次の読者へ渡します。応答は、たとえば`Vary:
Accept`のように、依存するフィールドを挙げる必要があります。それによ
り、キャッシュは、URLごとに一つではなく、版ごとに一つを保存します。

参考資料

  * RFC 9110：HTTPの意味 — すべての版に共通して、一度だけ定義するメ
ソッド、状態コード、ヘッダーフィールドです。

  * RFC 9111：HTTPキャッシュ —
保存した応答を再利用できる条件と、`Cache-Control`がキャッシュへ伝え
る内容です。

  * RFC 9112：HTTP/1.1 — テキストの通信形式、接続の扱い、メッセージ
の区切り方です。

  * RFC 9113：HTTP/2 — バイナリーのフレームと、一つの接続上の多数の
ストリームです。

  * RFC 9114：HTTP/3 — 同じ意味をQUICのストリームへ対応させたもので
す。

  * RFC 9457：HTTP APIの問題詳細 — 問題の内容を記述する、標準のJSON
本文です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/http/	engineer.company	70
