今さらですが、「Web API: The Good Parts」を読みました。 せっかくなので自分なりにまとめてみます。 1. URLについて 短く入力しやすいURL ×：http://sample.com/search-api/service/api/search ○：http://sample.com/api/search 人間が読んで理解できるURL ×：http://sample.com/api/u ○：http://sample.com/api/user 略すのもだめ products -> prod 大文字小文字が混在していないURL ×：http://sample.com/api/getUserInfo ○：http://sample.com/api/user 基本はすべて小文字 改造しやすい（Hackable）なURL ×：http://sample.com/api/ite
見てみると、たしかに Get 系の API だとしても POST を利用しているし、API の URL 設計に get_shared_link_file のようによく言われる REST っぽい設計は使っていなかった。 この方針は同意だ。自分は結構前に REST っぽい API を捨てることにした。だからといって REST API がダメだとかは思っていない。 一般ユーザが使う場合の API は REST API であるほうが慣れ親しんでいる場合が多いからだ。 AWS で利用されている HTTP API 仕様AWS の DynamoDB の Erlang/OTP ドライバーを書いているときに気づいたのだが、AWS の一部のサービスはかなり独特な API の仕様になっている。
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く