"user/get/{userId}", "user/get?userId={}", RequestBodyのどれを使用するか

Question

HTTPリクエストにおいて、以下の3種類があると考えています。

URL中に含める

user/get/{userId}

クエリパラメータとして渡す

user/get?userId={userId}

bodyに含める

（例えばJSONなど）

{
  "userID": XXX
}

これらのうち、どういった場合にどれを使用するのがベター、といったことはあるでしょうか？

Answer 1

RESTful API の流儀に従い、

GET /user/{userId}

でよいんじゃないでしょうか。

そうしたくない理由があるときはそうしなければよいと思いますが、
そうしたくない理由が特にないのであれば RESTful でよいかと思います。

Comments

[sho03]

ありがとうございます！RESTfulのお作法に従います！