RESTful準拠設計

Question

が銀行口座の作成/破棄を可能にするREST銀行アプリケーションを開発する必要があるとします。また、アカウントの操作：withdraw/credit/getBalanceを にすることができます。この操作は べき等であるため、クライアントがURLに

を与えているので、代わりにPOSTのPUT
• アカウントの作成

PUT /銀行/ジョン・

ここで私が使用して

• アカウントの破壊

DELETE /銀行/ジョン・

• GetBalance

GET /銀行/ジョン・

• 口座からお金を引き出し

POST /銀行/ジョン・

action = withdraw &値= 10

• クレジットお金アクション=クレジット&値=ここ10

  POST /銀行/ジョン・

アカウントに撤退/クレジットので、私はPOSTを使用しました明らかに冪等ではありません。

これらの操作を設計するためのRESTful準拠の方法はありますか？

私は（撤退|クレジット）の動詞を置くことにより、RPCのような何か書いています感じてい 内のactionパラメータを...と私は、多くの場合、その残りの部分を読むには、RPCのようなスタイルを模倣するべきではありません。..

Answer 1

"action = credit & value = 10"というものを追加する必要はありません。より多くの/より長いURIを作成することができます。たとえば ：

create an account: POST /Bank/Accounts/John 
credit money to an account: POST /Bank/John/Money/10 

Answer 2

RESTを扱うとき、それは一般的に資源の観点で考えることから始めるのに役立ちます。この場合、あなたのリソースはあなたの「銀行口座」だけではなく、その銀行口座の取引です。

預金

POST /Bank/Account/John/Transaction 

currency=USD&amount=10 

POST /Bank/Account/John/Transaction 

currency=USD&amount=-10 

あなたの応答は、この新しく作成されたトランザクションにLocationヘッダーを含める必要があります撤回。

トランザクションを作成しています。これの利点は、そのトランザクションをリソースとして参照できることです。

GET /Bank/Account/John/Transaction/12345 

これは、正確なトランザクション（例えば、ユーザーが一般的に自分のアカウントに借方と貸方の記録をしたい）のレコードを返すことができます。