(URL設計)HTTPメソッドとURIの関係を理解したい

Question

##背景

「Webを支える技術」という本の、URI設計の話を読んでいた時の話。
「URIは名詞」として成り立ち、HTTPメソッドと目的語・動詞の関係になるように
設計すべしという指針が紹介されておりました。

###例

HTTPメソッド	URI	意味
GET	users/1	ユーザ一覧の/会員番号1の情報 を取得(GET)してくれ

上記の例だと、指針に沿っており、理解出来ます。

##でもちょっと待って欲しい

しかしながら下記の例だと、どうにも納得いきませんでした。

HTTPメソッド	URI	意味
GET	users/1/edit	ユーザ一覧の/会員番号１の/編集　を取得してくれ

editとGETは動詞、動詞の関係になってしまうように思えて
設計指針からは外れているように思えます。

###仮説
ググりつつ、仮説をいくつか考えてみました。

• (1)HTTPメソッドは数が少ないので、表現の幅を広げるために動詞+動詞にした

https://dev.classmethod.jp/etc/web-api_rest-api_url-design/

• (2)リソースが未確定ならばOK(リソースの状態が確定していないから?)
• (3)editの名詞系として使っている

###相談
正しい理解は↑の3つに含まれているのか、
あるいは全く別の理解の仕方があるのでしょうか？
詳しい方、教えていただけると嬉しいです。

Answer 1

users/1 というのが何かしらのコマンドの省略形であると捉えれば、整理できて意味が通ります。

HTTPメソッド	URI	意味
GET	users/1	ユーザ一覧の/会員番号1の（/内容を表示する)ページを　取得
GET	users/1/edit	ユーザ一覧の/会員番号1の/編集をするページを　取得

一般的に 1行目のようなパターンは、users/1/view や users/1/detail のように、本来は何かしらのコマンド（様のもの）がくっついているのを省略していると解釈されます。
※標準的な機能なので、何も指定しなければそのコマンドが指定されているものと暗黙に処理される

HTTPメソッドとしての GET は、「～を取得する」という意味通りなので、それによって返ってくるものが何かは実体によって異なってきます。Web ページ（HTML）なのか、実データ（JSON 等）なのか、あるいは Excel ファイルなのかは分かりませんが、とにかく「GET」であれば何かしらのデータが帰ってくる、と期待すればよいようになっています。

Comments

[alyoalyoalyo]

ありがとうございます！しっくりきました。
tacsheavenさんには前回も助けて頂いて、感謝のかぎりです。

Answer 2

個人的には、「編集画面を取得する」というように理解しています。

edit_screenとすると長くて煩雑なので、editに短縮しているという解釈です。

Comments

[alyoalyoalyo]

早速のご回答ありがとうございます。
ある名詞の短縮系ということですね。