APIデザイン・パターン

マイナビ出版

JJ Geewax（著者）、松田晃一（翻訳）

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

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デザインという魅力的かつ複雑な世界において、多くの会話や将来の仕事のきっかけとなることを願っています。

［対象読者］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章リクエストの認証

発売日：2022-08-26

ページ数：528ページ

目次：
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章リクエストの認証

著者プロフィール

JJ Geewax（著者）

[著者]　JJ Geewax: はGoogle のソフトウェアエンジニアで、リアルタイム決済システム、クラウドインフラ、API 設計を専門としている。“Google Cloud Platform in Action”（Manning Publications）の著者であり、GoogleではじまったAPI設計標準に関する業界全体のコラボレーションであるAIP.devの共同設立者。

[翻訳]　松田晃一: 博士（工学、東京大学）。コンピュータで人生を「少し楽しく」「少しおもしろく」「少し新しく」「少し便利に」すること、HCI/AR/VR/UX、画像処理、機械学習、説明可能性、MLOps、モバイル機器、書籍の執筆、技術書、SF、一般書の翻訳などに興味を持つ。著書に『WebGL Programming Guide』（Addison-Wesley Professional）など、訳書に『プログラミングのための数学』（マイナビ出版）、『生成Deep Learning』（オライリー・ジャパン）、『デザインのためのデザイン』（ピアソン桐原）などがある。

オススメの連載

連載一覧へ

絶賛！発売中！

書籍一覧へ

7259件中 1-4件目12 3 4 5 6 7 8 9 10 次へ最後