どんなときに REST より GraphQL を選ぶのか、そして選ばないのはどんなときか?

REST を選ぶとき

• シンプルで均一なリソース と予測可能なアクセス — すべてのクライアントが同じ形を望む CRUD。
• HTTP キャッシュ / CDN が最も重要 — REST の URL + GET モデルはあらゆる層で簡単にキャッシュされます。GraphQL が近づくには persisted query が必要です。
• ファイルのアップロード/ダウンロード、バイナリ、または公開 API で、幅広いツール、ステータスコード、シンプルさが有利な場合。
• 小さなチーム / 低い複雑さ — GraphQL のサーバー側コスト (リゾルバ、N+1 制御、クエリコスト制限、スキーマツール) は、少数のエンドポイントには見合いません。

正直なトレードオフの表

これらは排他的でもありません — 多くのシステムは公開/キャッシュ可能なエンドポイントに REST を、リッチな内部クライアントに GraphQL を公開します。

なぜ重要なのか

シニアの面接官は 忠誠心ではなく判断力 を試しています。強い答えは軸を挙げ — クライアントの多様性、キャッシュのニーズ、チームの成熟度、DoS の攻撃面 — そして GraphQL を無条件に優れていると売り込むのではなく、その本当のコスト (キャッシュとクエリコスト制御) を認めます。