書籍
Web API: The Good Parts
水野貴明
概要
RESTful APIのエンドポイント設計やHTTPメソッドの適切な利用法を解説し、 美しく保守しやすいAPIを設計するための事実上の標準ガイド。
対象読者
- Web APIの設計原則を学びたいエンジニア
- RESTful API開発に関わる開発者
タグ
奥付
- 出版社
- オライリー・ジャパン
- ISBN
- 978-4873116860
- 出版日
- 2014年11月
- 参考定価
- ￥2,420税込Amazonの実売価格と異なる場合があります
この本を手に入れる
※ 上記は Amazon アソシエイトによる広告リンクです。関連書籍
前提となる書籍
- 推奨前提
マスタリングTCP/IP 入門編 第6版
井上直也、村山公保、竹下隆史、荒井透、苅田幸雄
理由: TCP/IP と HTTP の動作原理を理解すると、その上に成り立つ REST API の設計判断が「なぜそうするか」まで腑に落ちる。Web API The Good Parts は HTTP の意味論を踏まえた URI・メソッド・ステータスコードの実践的な設計指針を与える。
- 推奨前提
Webを支える技術
HTTP、URI、HTML、そしてREST
山本陽平
理由: Web の基盤技術を一通り押さえたら、それを使って「良い API」をどう設計するかという実践へ進む。Web API The Good Parts は HTTP の意味論に忠実な URI 設計・エラー表現・バージョニングの定石を与え、原理を設計判断に変換する。
- 参考
Clean Code
アジャイルソフトウェア達人の技
Robert C. Martin
理由: 良いコードの感覚は、関数やクラスの内部だけでなく、外部に公開する API の設計にも地続きで効く。命名・一貫性・予測可能性というクリーンコードの原則を、URI やレスポンス設計という API の「公開された名前」へ広げて考える。
次に読む書籍
- 推奨前提
Web APIの設計
The Design of Web APIs
Arnaud Lauret
理由: REST の基本的な設計指針を身につけたら、API を「契約」として記述・共有する実践へ進む。The Design of Web APIs は OpenAPI による仕様駆動の設計プロセスを示し、場当たりでない一貫した API を組織で作るための型を与える。
- 推奨前提
OpenID Connect入門
アプリケーション開発者のための実践技術解説
土岐孝平
理由: API の設計ができるようになったら、その API を「誰がどの権限で叩けるか」を制御する認証・認可の層が要る。OpenID Connect は OAuth 2.0 を土台に本人確認を標準化した仕組みで、トークンベースのアクセス制御を API に組み込む定石を与える。
- 参考
初めてのGraphQL
Learning GraphQL
Eve Porcello、Alex Banks
理由: REST の設計を理解すると、その制約（過剰取得・往復回数）への対案として GraphQL の発想が際立つ。Learning GraphQL はクライアント主導のクエリとスキーマ駆動の型システムを学ばせ、REST との使い分けの判断軸を与える。
- 参考
gRPCアップアンドランニング
gRPC: Up and Running
Kasun Indrasiri、Danesh Kuruppu
理由: テキストベースの REST を押さえたうえで、サービス間通信の高効率な選択肢として gRPC へ視野を広げる。gRPC Up and Running は Protocol Buffers による契約定義と双方向ストリーミングを学ばせ、内部マイクロサービス通信の現実解を示す。