
Web APIの設計
Arnaud Lauret、株式会社クイープ
翔泳社 / 2020-08-26
この本について
APIを作っていると、「これ…本当に使う人にとってわかりやすいのか?」と手が止まる瞬間がけっこうあります。パラメータ名の付け方ひとつ、日付フォーマットひとつでも自信が揺らぐし、エラーをどう返すべきかになると急に霧が出たようになる。自分もよくそこで迷っていました。 『Web APIの設計』が助かったのは、抽象的な“良いAPIとは”ではなく、実際の設計でつまずく具体的なポイントに丁寧に踏み込んでくるところです。例えば、description を必ず書く理由を「名前だけでは伝わらない」と言い切ってくれたり、エラーも不正形式・機能的・サーバーの3種類にまず分けることで頭が整理される。さらに、日付やIDのフォーマットをどう選ぶかについても、実運用で起きる誤解や事故の目線で説明してくれるので、読みながら自分のAPIの問題点がどんどん具体化していきました。 特に、APIのゴールを先に洗い出し、コンシューマの視点で「何を達成できるようにするのか」を明確にしてから設計に入る、という流れは、自分の混乱の原因が“仕様よりも先に形だけ作ろうとしていたこと”だったと気づかせてくれました。OASをどう使うかも、ただの記述形式ではなく「一貫性のための道具」として位置づけてくれるので理解が深まります。 仕様書を書くたびに「この判断、ほんとに正しい?」と不安になる人に、かなり刺さる一冊だと思います。自信をくれるというより、判断の基準を静かに補強してくれる本です。
読書インサイト
ハイライト密度
多くの読者は第5章に最もインサイトを感じており、全ハイライトの21%が集中しています。
読書の順序
この本に似ている本
すべて見る arrow_right_alt![現場で使える Django REST Framework の教科書[3.2 LTS 対応版] (Django の教科書シリーズ)](https://m.media-amazon.com/images/I/71W-G805e0L._SY500.jpg)
現場で使える Django REST Framework の教科書[3.2 LTS 対応版] (Django の教科書シリーズ)
横瀬 明仁

デジタルアイデンティティー 経営者が知らないサイバービジネスの核心
崎村 夏彦

現場で役立つシステム設計の原則 〜変更を楽で安全にするオブジェクト指向の実践技法
増田 亨

絵で見てわかるクラウドインフラとAPIの仕組み
平山毅, 中島倫明, 中井悦司, 矢口悟志, 森山京平, and 元木顕弘

はじめての設計をやり抜くための本 第2版 概念モデリングからアプリケーション、データベース、アーキテクチャ設計、アジャイル開発まで
吉原 庄三郎
書籍情報(出版社紹介・目次)expand_more
出版社による紹介
読んだ内容を、もう忘れない。
BookNotion Zなら、Kindleのハイライトを自動で保存・整理。Notionにエクスポートして、いつでも振り返れます。
クレジットカード不要