Parts」を一気に読んでみた。API初心者向けだと思う。内容は平易でよくまとまっていてわかりやすい。僕もちょっとだけAPIを書いたことはあるけれど、きちんとしたものを作った経験がないし、周辺の知識が欠けていると思って手にとって見たけれど、読み終わって思うのは読んでよかったなぁという感じ。Parts気になったところを書き出してみる。自分のものになっていないものも多く含まれると思うけれど、書き出すことで一旦整理できれば。あとで検索できるようにページ数も書いておく。気になった所メモ感想も入ります。p.12ウェブページをAPIに変換するサービスPOSTで送信したデータは指定したURIに従属(subordinate)したものになる。p.31例えば、https://api.example.com/v1/friendsにPOSTすると、https://api.example.com/v1/friends/12345が新たに生成されるイメージ。PUTはhttps://api.example.com/v1/friends/12345に対してその内容を書き換える。PUTは送信するデータでリソースを完全に上書きする。p.60一つの画面を表示するためにコールするのが1つのAPIですむようにそれに合わせたAPIを用意し、何らかのデータをサーバに保存する場合にも1回のコールですむようにそれ向けのAPIを用意するのが良いということこういう風に考えていいんだと思った。目的に応じて複数コールするのか1つで済ませるのか迷ってたけど、こういう風に考えていいんだと思った。p.76https://api.example.com/v1/users/12345?fields=name,ageというようにレスポンスの内容をユーザが選べるようにするのも手。FacebookのAPIもこんな感じだったな。-p.86JSONがベースとしているJavaScriptの命名規約において、キャメルケースの利用がルール付けされているケースが多いから。p.96エラーメッセージには開発者向けのメッセージを含めるのも良いエラーコードってどういう感じに振ればよいか曖昧だったので指針をもらった感じ。p.159ただし、OpenSSLのバグ、SSL証明書の偽造などがあるので100%安全とはいえない毎回のAPIアクセスの際にAPIの残りアクセス可能回数などをレスポンスに含めてクライアントに返す。コメントデータの処理方法の詳細はこちらをご覧ください。