「WebAPI 設計のベストプラクティス」に対する所感 - Qiita

「翻訳: WebAPI 設計のベストプラクティス」を読んで色々と思うところがあったので書きました。 上記の記事は訳文でありますので、正しくは「Best Practices for Designing a Pragmatic RESTful API」に対する所感と述べた方が良いのかもしれませんが、日本語で通して読めるよう Qiita に投稿された訳文に対する所感として書いています。 以下では「翻訳: WebAPI 設計のベストプラクティス」並びに「Best Practices for Designing a Pragmatic RESTful API」は「当該記事」と表現します。 観点 当該記事では「○○とした方がよい」との意見に対してそうすべき理由が明らかになっていないか、もしくは表現が曖昧な場合が目立っていると感じました。設計は実装のようにプログラム言語仕様が制約を与えられないため、意図

[kawa-_-kawa]

バージョンURLに含めたらダメなのか。運用（変更）コストとも兼ね合いになるので自分は妥協して使っています。無い方が良いのはその通りだと思います。

[kwhrtsk]

バージョンが変わると機能(例えばGETならレスポンス)も変わるならそれはバージョンの違うリソースなのでURLにバージョン入れて違うエンドポイントに定義するべきなのではと思った。

[k2wanko]

RESTが辛いのでRPCに行きたい

[tzt]

広く公開するAPIならこんな感じなんだろうなあ。アプリだと画面ごとに効率よくなるよう作りこんだりだとかだしな。

[jakalada]

"かっこよくデザインされた仕様書よりも API を使うアプリケーションの開発の負担を減らすような仕様書である方が合理的です。"

[redredstar]

全然関係ないが、未だにXMLで返そうとしてくる設計者にJSONを推すための材料が欲しい

[enemyoffreedom]

2016年3月の記事

[nilab]

「そうすべき理由が明らかになっていないか、もしくは表現が曖昧な場合が目立っていると感じました。設計は実装のようにプログラム言語仕様が制約を与えられないため、意図を明確にすることが何よりも重要です」

[isdh]

“設計は実装のようにプログラム言語仕様が制約を与えられないため、意図を明確にすることが何よりも重要です。”

[smihara]

“り利用者が誰であるかは特定されます。利用者が持つ属性の一つとして「バージョン○○の API を使う」という情報を得られるようにすれば、利用者個々が異なるバージョンの API を利用できます。このような仕組みをオ

[o_hiroyuki]

設計

[yuya_presto]

元記事と合わせて読みたい

[surume000]

REST厨は誰のためにがんばっているんだろう？ユーザーのためでも、開発者のためでもない気がするんだけど。

[tolkine9999h]

こちらも合わせて

[ttakezawa]

ぼくも「当該記事」を読んでめっちゃもやもやしてたので、こういう記事はとても嬉しい

[baca-aho-doji]

すごくわかりやすくて「なぜ」の部分にフォーカスがあたっているので勉強になった。疎結合の話で依存性注入にまで話が及んでて大変参考になりました。

[hogege]

φ(･_･

[masudaK]

ほんと正解知りたい

[northlight]

WebAPI はシステム間の依存性を排除するのが存在理由の一つ

[t_yamo]

どちらも分かるけれど「/inu_no_john」の暗黙知抑制の話と「複数のリソースを包含的に示すリソース」による横断的なアクションとの関係が気になる。前者はもう少し詰めてロジックを立てる余地があるのかな。

[bigchu]

: 設計

[digitalglm]

「WebAPI 設計のベストプラクティス」に対する所感 - Qiita: 「 翻訳: WebAPI 設計のベストプラクティス 」を読んで色々と思うところがあったので書きました。 上記の記事は訳文でありますので、正しくは「 Best…

[poppun1940]

「 翻訳: WebAPI 設計のベストプラクティス 」を読んで色々と思うところがあったので書きました。 上記の記事は訳文でありますので、正しくは「 Best Practices for Designing a Pragmatic RESTful API 」に対する所感と述べた方が良いの

[ginzi009]

「WebAPI 設計のベストプラクティス」に対する所感

[akulog]

#toki3_memo

[pero_0104]

やべえなるほど すげー分かりやすい…見直してくる！

[ko-ya-ma]

なるほど！ “仕様書はモックサーバとして動くようにする”

[HHR]

結局「複数のリソースを横断的に検索するようなアクション」はどうすれば…

[miragestlike]

良い記事だ

[kgrock]

「WebAPI 設計のベストプラクティス」に対する所感

[tkawa]

『「何故それが必要なのか」という理由を意識し、周りとそれを共有するよう心がけるのが肝要』良い議論