Arnaud Lauret(著) , 株式会社クイープ(翻訳) , 株式会社クイープ(監修)
※1点の税込金額となります。 複数の商品をご購入いただいた場合のお支払金額は、 単品の税込金額の合計額とは異なる場合がございますので、予めご了承ください。
【本書の内容】
本書は
Arnaud Lauret, "The Design of Web APIs",
Manning Publications, 2019
の邦訳版です。
SNSはもちろん動画システムや決済システムなど、いまやAPI(アプリケーション・プログラミング・インターフェイス)を使用しないWeb上のシステムはありません。
データを簡便にリクエストでき、使いやすいデータを返す。そういうAPIが求められています。
とはいえ、データをリクエストしてくるのは一か所ではありません。カスタマーがいてコンシューマーがいてデベロッパーがいて、そしてそれぞれがそれぞれの都合に合わせた使えるデータを要求してきます。
本書はこういった複雑な要望に対して、可能な限り応ええる柔軟性を備え、堅牢でシンプルなAPIを作る方策を示します。
コマース系のサイトをベースに、データの配置方法や拡張性を維持し続ける方法などを、実装ありきではないスタイルで、APIのすべてを語り尽くしています。また、メンテナンス性や、より多くのユーザーを獲得するためのドキュメントの記述・完備方法なども詳解します。
突貫で作りがちなAPIを、その使い勝手にフォーカスしながら正しく作り込んでいくための視点と姿勢を体得できる一冊です。
本書は、著者Arnaud Lauretの長年のAPI設計経験を利用し、
要件を収集する方法、ビジネス目標と技術目標のバランスを取る方法、
および消費者第一の考え方を採用する方法について、仔細に検討し、
より使いやすく可用性に富み、拡張性と堅牢性をもつAPI構築への道を詳解してくれます。
【本書のポイント】
・使うだけではなく使えるAPIを理解できる
・API設計の勘所がつかめるようになる
・実世界におけるユーザー指向APIを学べる
・手書き風の概念図がかわいい
【読者が得られること】
・APIの成り立ち
・使いやすいAPIの作り方
・可用性・発展性のあるAPIの設計方法
本書はArnaud Lauret著『The Design of Web APIs』(Manning Publications, 2019)の邦訳です。
コマース系のサイトをベースに、データの配置方法や拡張性を維持し続ける方法などを、実装ありきではないスタイルで、APIのすべてを語り尽くしています。また、メンテナンス性や、より多くのユーザーを獲得するためのドキュメントの記述・完備方法なども詳解します。突貫で作りがちなAPIを、その使い勝手にフォーカスしながら正しく作り込んでいくための視点と姿勢を体得できる一冊です。
第1部では、APIの設計に必要な、最も基本的な概念とスキルを取り上げます。
第2部では、「考えさせない」APIの設計方法に着目します。考えさせないAPIとは、理解しやすく使いやすいAPIのことです。
第3部では、「APIを取り巻くコンテキスト全体」および「APIの設計プロセスそのものを取り巻くコンテキスト全体」など、APIの設計者が考慮に入れなければならないことを示します。
複雑な事柄は図表付き解説。明確なイメージが理解を助けます。
覚えておきたいことを「コラム」や「Note」などで補足解説しています。プラスαの知識が身につきます。
コードのポイントとなる部分には注釈コメントを載せています。より理解が深まります。
第1部 APIデザインの基礎
第1章 APIデザインとは何か
第2章 ユーザーを意識したAPIを設計する
第3章 プログラミングインターフェイスを設計する
第4章 API記述フォーマットを使ってAPIを記述する
第2部 ユーザブルなAPIの設計
第5章 単純明快なAPIを設計する
第6章 予測可能なAPIを設計する
第7章 うまく整理された簡潔なAPIを設計する
第3部 コンテキストに応じたAPIデザイン
第8章 セキュアなAPIを設計する
第9章 APIの設計を進化させる
第10章 ネットワーク効率のよいAPIを設計する
第11章 コンテキストに基づいてAPIを設計する
第12章 APIを文書化する
第13章 APIを成長させる
kannkyo さん
2021-05-21
Web APIの”設計”の入門書。具体的な事例を挙げて、設計の流れを豊富な図とコードで解説。API の設計者と利用者 の双方の視点を踏まえつつ、APIライフサイクルを通じて発生するタスクを具体的に説明。特に、APIの変更容易性を実現するアーキテクチャに関する検討は、実務的視点に富んでおり、一見の価値有。
iwtn_ さん
2021-12-30
タイトルの通りの内容が、包括的に記述されている良書。手法としてはRESTを中心にしているが、GraphQLやgRPCにも言及している。文書化の重要性も説いており、WebAPIとしてサービスを設計するのであれば、読んでおいて間違いのない本。 あるサービスは社会の一部であり、他のサービスと連携することによって、更に力を発揮できる。そして人間だけでなく、コンピュータによって連携できるようになることが、昨今よく言われるDXだと思う。民間のサービスだけでなく行政なんかもWebAPIを作っていくようになって欲しい。
ミ酉 さん
2021-11-21
なんだかんだ買ってから一年くらいかかってしまったがようやく読了。API設計の基礎が一本にまとまっていて、非常にわかりやすい。アプリエラーをステータスコード200で返すような現場に一冊。