はじめに

アプリ開発をしていると、「APIってどう設計すればいいんだっけ？」と迷うことは少なくありません。特に REST API、BFF（Backend For Frontend）、GraphQL の3つは、それぞれ思想も向いているケースも違うため、正解がわかりづらい領域です。

この記事では、それぞれの設計手法について調べた内容をもとに、違いや使い分け方を整理してみました。よく使われている実際のサービスの例も紹介しているので、API設計に悩んでいる方の判断材料になれば幸いです。

それぞれの概要とAPI例（＋向いているフロントエンド）

GET    /users
GET    /users/{id}
POST   /users
PUT    /users/{id}
DELETE /users/{id}
GET    /users/{id}/posts

GET /api/dashboard/init
GET /api/profile-page/init
GET /api/product-detail/123
POST /api/checkout/confirm

query {
  user(id: "1") {
    name
    email
    posts {
      title
    }
  }
}

項目	REST API	BFF	GraphQL
設計単位	リソース	画面	フィールド
エンドポイント構成	複数	画面単位	単一
フロント側の組み立て	必要	ほぼ不要	必要（だが柔軟）
通信効率	普通	高	高
再利用性	高	低め	高いが設計依存
サーバー実装コスト	中	中	高
キャッシュ性	高（HTTP対応）	普通	低（手動対応が必要）

GitHub は両方の方式を提供しており、RESTは汎用的なリソースアクセスに、GraphQLは柔軟で効率的なクエリ取得に向いています。

Netflix では、デバイス（モバイル・TV・Web）ごとに BFF を構築しており、画面に必要な情報をまとめて取得する構成が採用されています。

Shopify も REST と GraphQL の両方を提供しており、現在は GraphQL が推奨されています。必要なデータを効率よく取得できる利点があります。

モバイルアプリの初期表示速度を最適化するために、画面単位のBFF構成を採用しています。

※筆者自身は GraphQL をまだ実装したことはなく、あくまで調査ベースでの整理となっています。
実際に手を動かした経験としては REST API と BFF の方が多いです。GraphQL にも今後トライしてみたい！という気持ちはあります 😄

API設計	向いているフロントエンド例
REST API	Web SPA、管理画面、外部API連携あり
BFF	モバイルアプリ、SSR Webアプリ、画面単位での開発
GraphQL	柔軟に変わるUI、複数チーム/クライアントが存在するプロダクト

読んでくださってありがとうございました！APIの設計に正解はありませんが、目的に応じた選択をするための整理になれば嬉しいです。

もし他にもこんな設計方針で悩んだ経験がある方は、ぜひコメントなどで教えてください。