【感想】Web APIの設計

〇APIのセキュリティ
　1.ユーザを登録する
　2.APIを利用するためのトークンを取得
　3.トークンを使用してAPIを呼び出す

〇バージョニング
　APIレベルでバージョニングするのがベストプ…ラクティス
　リソースレベルでのバージョニングはユーザにとってわかりづらい。

〇同期的でないAPI
　・Web Hook
　クライアント側にポーリングさせるのではなく、サーバ側からあらかじめ登録されたURLにPOSTする。

　・イベントストリーム
　SSE(Server-Sent Event)
　HTTPプロトコルでレスポンスデータに情報を流し続ける。続きを読む

API何それわからん的な私から見たら、だいぶ専門的でハードル高かった。
紹介読んで、基本的なこと書かれているかなーって思ってパラパラ読んだけど、難しかったな。。（ふりがなJSの本みたいなのを期待してし…まった）

ある程度わかってきてから読んだら、良書な感じがする。続きを読む

会社で買ってもらったので、まずは流し読み。

階層設計からセキュリティ・性能を視野に入れた考慮ポイント、利用ユーザー向けのマニュアルやライフサイクル等々、Web API の設計運用に必要なことが網羅さ…れている感じです。
その分ボリュームは多めですが、Web API 提供者は持っておくと良い一冊かと。続きを読む

WebAPIを設計するための考え方について非常に勉強になりました。
APIとは？から始まり、ユーザーを意識した使いやすいAPIの考え方、RESTについて、ドキュメントの作り方、セキュリティ、バージョニ…ング、などが書かれています。
設計に関する本なので「どのように考えながら設計していくか」を知ることができました。
便利なAPI作りたいけどどうやったらいいんだろう。って状態だったので非常にタメになりました。続きを読む