先日初めて、自分が書いたブログの記事、Web API設計指針を考えたがはてブでバズるという経験をしました。たくさんの方に読んでいただけたというのは非常にうれしいことです。ただ、設計指針には根拠を書かなかった箇所が多く補足したいところが出てきたため、以下の内容について根拠などを書いていきたいと思います。 バージョニングについて RESTfulについて バージョニングの設計・実装について 以下の指針を書きました。 APIにはバージョンをつける。 vと整数のバージョン番号をURLにつける。 バージョンは整数。マイナーバージョンは作らない。 例） http://api.example.com/v1/users 上記指針をRailsで実装する場合には、バージョンを上げるときにはコントローラごと分けるようにしています。 ただ、少々前の話になりますが、こんな記事がありました。 APIのバージョニングは限
2016/10/12 社内勉強会で使ったスライドを社外向けに一部加筆訂正したもの
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? これは Enchant の開発者である Vinay Sahni さんが書いた記事「Best Practices for Designing a Pragmatic RESTful API」1を、ご本人の許可を得て翻訳したものです。 RESTful な WebAPI を設計しようとすると、細かなところで長考したり議論したりすると思います。また、他の API に倣ってやってはみたものの、本当にそれでいいのか、どうしてそうしているのか分からない、何てことも少なくはないと思います。 この記事では、そのようなハマリどころについて Vinay さん
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く