APIデザイン・パターン

JJGeewax / 松田晃一

※この商品はタブレットなど大きいディスプレイを備えた端末で読むことに適しています。また、文字だけを拡大することや、文字列のハイライト、検索、辞書の参照、引用などの機能が使用できません。

Web API設計のベストプラクティス集

APIとはアプリケーション、サービス、コンポーネントがどのように通信するかを定義する仕様です。本書『APIデザイン・パターン』は、Web APIを構築するための安全かつ柔軟で再利用可能なパターンを提供するために執筆されました。一般的な設計原則の説明からはじめ、APIを構築する際の仕様、デザイン・パターンを紹介していきます。Manning Publishing: API Design Patterns の翻訳書。

本書 "APIデザイン・パターン（API Design Patterns）" は、Web APIを構築するための一連の設計原則、安全かつ柔軟で再利用可能なパターンを提供するために書かれました。Google Cloud PlatformとそのAPI設計に取り組む著者が、

・APIの一貫性、拡張性、可用性を確保する方法について
・安全かつ柔軟で再利用可能なAPIパターン
・一般的なAPIの設計を改善する手法

について解説します。コード例はTypeScriptで解説。詳細なシナリオ・図解により、API設計についての理解が深まります。

提供するAPIが他の開発者から信頼され、便利に使ってもらえるようにするためのベストプラクティスを提供します。


［本書まえがきより］
ソフトウェアが「うまく設計されている」とはどういうことなのか、「よく設計されたWeb API」とは何か。
私は自分自身で答えを出そうとし、実際に使ってみた情報などを何年もかけ集約し、Luke Sneeringerと私でGoogleのルールとして明文化し、それは最終的にAIP.dev（google.aip.dev）という形で提供することになりました。これらのルールはある種の法律のようなもので「何をすべきか」は書かれていても、「なぜそうすべきか」は書かれていません。この本で私が目指したのは実践的なガイドラインと、その理由を論理的に説明することです。この本で取り上げたトピックが、APIデザインという魅力的かつ複雑な世界において、多くの会話や将来の仕事のきっかけとなることを願っています。

• カテゴリ: ビジネス・実用
• ジャンル: IT・コンピュータ / 全般
• 出版社: マイナビ出版
• 掲載誌・レーベル: Compass Booksシリーズ
• ページ数: 528ページ
• 電子版発売日: 2022年09月02日
• コンテンツ形式: EPUB
• サイズ(目安): 120MB

[ブクログ · ★★★★☆]

「一般的なPOSTやPUTの役割からちょっと外れてる処理」をどうAPIとして落とし込めば良いか、これまでは明確な基準がなく、モヤっとしたことが多くあった。本書ではその辺りの線引きや指針を提示してくれており、今後の業務に活かしていけそうな有用なデザインパターンが多く紹介されている。
「カスタムメソッド」は特に非常に参考になり、すぐ取り入れていきたい。
日本語訳の言い回しの問題なのか、伝えたい意図の分かりづらい箇所がいくつかある。脱字や誤植も散見され、少し読みづらいのが残念。