【入門編】 HTTPステータスコード429(Too Many Requests)の役割 – Web APIアーキテクチャ・データ連携実践ガイド

APIの「行列」を整理せよ！HTTP 429 Too Many Requestsが守る平和な世界

こんにちは！ネットワークの世界にどっぷり浸かって、パケットの流れる音を聞きながらコーヒーを飲むのが至福のインフラエンジニアです。

今日は、Web API開発やインフラ構築の現場で避けては通れない、でも意外と正しく理解されていない「ガードマン」のような存在、429 Too Many Requestsについてお話しします。

「APIをたくさん叩いたらエラーになった」という経験はありませんか？なぜサーバーは冷たく門前払いをするのか。そこには、ネットワークの世界を守るための深い理由があるんです。

—

郵便配達で例える「レートリミット」の重要性

まず、インターネットの世界を「郵便局」に例えてみましょう。

ある郵便局（APIサーバー）に、一人の利用者が猛スピードで手紙（リクエスト）を出しに来たとします。1秒間に1,000通もの手紙が届いたら、郵便局員（サーバーのCPUやメモリ）はどうなるでしょうか？

他の人の手紙を処理できなくなる。
整理が追いつかず、局内がパニックになる。
最悪の場合、郵便局自体が倒れて営業停止（ダウン）してしまう。

この「郵便局がパンクしないように、一人あたりの受付数を制限する」ルールがレートリミットです。そして、制限を超えてやってきた相手に対して、「ごめんなさい、今は混んでいるのでまた後で来てくださいね」と伝えるのが、今回主役の 429 Too Many Requests というステータスコードなんです。

なぜ「429」を返すことが美しい設計なのか？

REST APIの設計において、429 を適切に返すことは非常に重要です。これを無視して適当なエラーを返すと、クライアント（アプリ側）は「サーバーが壊れたのかな？」と勘違いして、さらにリクエストを送り続けてしまう（再試行ループ）という負の連鎖を生んでしまいます。

429 を返すと、クライアントは「ああ、今は制限がかかっているんだな。少し休んでから再開しよう」と判断できます。つまり、相互理解によるネットワークの保護こそが、美しいAPI設計の極意なのです。

実践！賢いサーバーはどうやって「お断り」しているのか

インフラエンジニアとして現場でよく使う、Nginxを使ったレートリミット設定を見てみましょう。この設定を入れると、サーバーは自動的に「お断り」をしてくれるようになります。

# 1秒間に1リクエストだけ許可する「バケツ」を用意する（zoneの設定）
# ここでは「mylimit」という名前で共有メモリを確保しています
limit_req_zone $binary_remote_addr zone=mylimit:10m rate=1r/s;

server {
    location /api/ {
        # 上記のルールを適用。バケツが溢れたら 429 を返す
        limit_req zone=mylimit burst=5 nodelay;
    }
}

rate=1r/s: 「1秒間に1回だけね」という約束。
burst=5: 「少しなら待ってあげるよ（最大5回までは一時的に許容）」という優しさ。
nodelay: 待たせずに即座に処理する設定。

この設定があるだけで、あなたのサーバーは大量の無茶振りから身を守れるようになります。

クライアント側に求められる「礼儀」：Retry-Afterヘッダー

429 を返すとき、ただ突き放すのではなく、「あと何秒待てばいいか」を教えてあげるのがプロの流儀です。これには Retry-After というヘッダーを使います。

HTTP/1.1 429 Too Many Requests
Retry-After: 30
Content-Type: application/json

{
  "error": "リクエストが多すぎます。30秒後に再試行してください。"
}

クライアント側のプログラム（Pythonの例）でも、これを受け取る準備をしておくと非常にスマートです。

import time
import requests

response = requests.get("https://api.example.com/data")

# 429が返ってきたら、Retry-Afterヘッダーを見て待機する
if response.status_code == 429:
    wait_time = int(response.headers.get("Retry-After", 60))
    print(f"{wait_time}秒間、お行儀よく待機します...")
    time.sleep(wait_time)

まとめ：ネットワークは「思いやり」でできている

429 Too Many Requests は、単なるエラーコードではありません。それは、サーバーという限られたリソースを全員で公平に使い、ネットワーク全体を健全に保つための「大人のコミュニケーション」です。

サーバーは、限界を伝えてシステムを守る。
クライアントは、その制限を理解して待機する。

この仕組みを理解して設計できるようになれば、あなたはもう立派なインフラアーキテクトの仲間入りです！これからもパケットの心地よいリズムを感じながら、美しいAPIライフを楽しんでくださいね。

もし分からないことがあれば、いつでもまた聞きに来てください。ネットワークの世界は奥深くて、最高に面白いですよ！