1. ホーム
  2. rest

[解決済み】動詞のないREST URLを作成する方法は?

2022-03-31 21:18:47

質問

restful URLをどのように設計すればよいのか悩んでいます。 私は、動詞ではなく名詞でURLを使用するレストフルアプローチに賛成ですが、これを行う方法を理解していません。

金融電卓を実装するサービスを作っています。 電卓は、CSVファイル経由でアップロードされるパラメータの束を取ります。 ユースケースは以下のようなものです。

  1. 新しいパラメータのアップロード
  2. 最新のパラメータを取得する
  3. 指定された営業日のパラメータを取得する
  4. パラメータをアクティブにする
  5. パラメータを検証する

私は、レストフルアプローチは、以下のようなタイプのURLであると考えます。

/parameters
/parameters/12-23-2009

で最初の3つのユースケースを実現することができます。

  1. パラメータファイルをPOSTリクエストにインクルードするPOST
  2. 最初のURLのGET
  3. 2番目のURLのGET

しかし、4番目と5番目のユースケースは動詞なしでどのように行うのでしょうか? のようなURLが必要ではないでしょうか?

/parameters/ID/activate
/parameters/ID/validate

??

解決方法は?

おそらく、次のようなことでしょう。

PUT /parameters/activation HTTP/1.1
Content-Type: application/json; encoding=UTF-8
Content-Length: 18

{ "active": true }