API デザイン・パターン(エーピーアイデザインパターン)
その他- 著者:
- JJ Geewax/松田晃一(ジェイジェイ ジーワック)
- 出版社:
- マイナビ出版
- 出版日:
- 2022年08月26日頃
- ISBN:
- 9784839979393
- 価格:
- ¥4,785
- シリーズ:
- Compass Booksシリーズ
- 在庫:
- 1
- 判型:
- 単行本
なぜ注目されているか
書籍紹介
本書 "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 デザインという魅力的かつ複雑な世界において、多くの会話や将来の仕事のきっかけとなることを願っています。
[対象読者] Web API を構築している人、構築する予定の人。 API を一般に公開することを検討している場合に本書は有用です。 JSON などのシリアライゼーション・フォーマットや一般的なストレージ知識、 HTTP とそのメソッド (GET や POST) に精通していることは本書を理解する助けとなります。
目次:
PART 1 はじめに
第 1 章 API 入門
第 2 章 API デザインパターン入門
PART 2 設計の原則
第 3 章 名前付け
第 4 章 リソースの範囲と階層
第 5 章 データ型とデフォルト値
PART 3 基礎編
第 6 章 リソース識別子
第 7 章 標準メソッド
第 8 章 部分的な更新と取り出し
第 9 章 カスタムメソッド
第 10 章 ロングランオペレーション
第 11 章 再実行可能ジョブ
PART 4 リソース間の関係
第 12 章 シングルトンサブリソース
第 13 章 相互参照
第 14 章 アソシエーションリソース
第 15 章 カスタムメソッド: add 、 remove
第 16 章 ポリモーフィズム
PART 5 コレクションの操作
第 17 章 コピーと移動
第 18 章 バッチ操作
第 19 章 条件に基づく削除
第 20 章 匿名書き込み
第 21 章 ページ分割
第 22 章 フィルタリング
第 23 章 インポートとエクスポート
PART 6 安心と安全
第 24 章 バージョンと互換性
第 25 章 論理削除
第 26 章 リクエストの重複実行回避
第 27 章 リクエストの検証
第 28 章 リソースリビジョン
第 29 章 リクエストの再試行
第 30 章 リクエストの認証
言及 Qiita 記事 (1 件)
この本に興味がある方におすすめ
この本に関連
関連記事
Web デザイン本ガイド - HTML/CSS、Figma、Photoshop を学ぶ順番
Web デザインを独学する本の選び方を「コーディング、ツール、デザイン原則」の 3 本柱で整理。HTML/CSS の入門書、Figma と Photoshop の教本、レイアウトと配色の定番書を、2026 年 8 月時点の収載書から学ぶ順番つきで解説します。
あの有名 OSS のコードは、この本の影響を受けている
広く使われているオープンソースソフトウェアの設計には、技術書と共通の語彙や原則が残っています。OSS のコードから辿れる影響と、似ているだけの例の見分け方を整理しました。
設計 / アーキテクチャ本ガイド - 設計力を上げる技術書の選び方
ソフトウェア設計を学べる技術書をコード / モジュール / システムの 3 レイヤーに分類し、レベルに応じた読む順番の指針を紹介します。
関連用語
API
ソフトウェア同士が機能やデータをやり取りするための接続規約
REST API
HTTP メソッドとリソース指向の URL で設計する Web API のアーキテクチャスタイル
API Gateway
API のエントリーポイントとして認証、スロットリング、ルーティングを一元管理する AWS サービス
HTTP ステータスコード
HTTP レスポンスの結果を 3 桁の数値で表す標準コードで、1xx〜5xx の 5 カテゴリに分類される
Template Method パターン
アルゴリズムの骨格を親クラスで定義し、具体的なステップをサブクラスに委ねるデザインパターン
冪等性
同じ操作を何度実行しても結果が変わらない性質で、分散システムの信頼性を支える