Web API を作るたびに命名やリソース設計がぶれて、後から整合性を取り直すのがつらい。
そのままだと、機能追加のたびに例外ルールが増えて、使う側にも作る側にも負担が積み上がります。
この本は、API を一貫性・拡張性・可用性の観点でどう設計するかを、パターンとして整理しやすいのが良かったです。
こういう人に向いています
- Web API の設計ルールをチームで揃えたいバックエンドエンジニア
- API の命名やリソース設計で毎回迷ってしまう人
- REST API を運用しながら、長期的に壊れにくい設計へ寄せたい人
- API プラットフォームや共通基盤を整備するテックリード
読んだあとに変わること
- API 設計を場当たりの判断ではなく、原則とパターンで考えやすくなる
- 名前付け、リソース階層、標準メソッドの選び方に一貫性を持たせやすくなる
- 将来の拡張や互換性まで含めた設計レビューをしやすくなる
- 例外ケースや複雑な要件を、パターンとして整理して扱いやすくなる
実務で効きやすいポイント
- Google API の知見をベースにしているので、規模が大きくなっても崩れにくい設計思想として読みやすかった
- 名前付けやデータ型の扱いなど、地味だけれど後で効いてくる部分を丁寧に整理しやすかった
- 標準メソッド、部分更新、長時間処理など、現場で必ず悩む論点がまとまっていて助かった
- リソース間の関係やコレクション操作までパターンとして整理されており、設計ルールのたたき台にしやすかった
- API を単に公開するためではなく、長く運用できる形に整える視点が強いので、基盤整備の議論に持ち込みやすかった
さらに広げて読むなら
API を設計原則だけでなく、システム進化や運用まで含めて考えたいならこちらもつながります。
モノリスからAPI駆動へ進みたい人へ。設計・運用・移行まで見渡せる実践書
まとめ
API 設計を毎回ゼロから悩みたくないなら、この本でパターンを手元に置いておくと、レビューと実装の両方がかなり安定します。