URIにはHTTPアクション動詞が含まれています。このAPIをRESTfulと考えることはできますか？

Question

TutorialsPoint RESTfulな設計のコンテキストで次のメソッドを定義します。

URI   HTTP  Body   Result 
----------------------------------------------------------------- 
listUsers  GET  empty   Show list of all the users 
addUser  POST  JSON string Add details of new user 
deleteUser DELETE JSON string Delete an existing user 
:id   GET  empty   Show details of a user 

私はそれはRESTfulなはないので、これは、誤解を招くと思います。

RESTfulな設計には、次のようになります：

URI   HTTP  Body   Result 
---------------------------------------------------------------- 
users  GET  empty   Show list of all the users 
users  POST  JSON string Add details of new user 
users  DELETE empty   Delete an existing user 
users/:id GET  empty   Show details of a user 

は、RESTfulな正しいの私の理解ですか？ URL内のdeleteUserはすでにOnce And Only Onceの普遍的原則に違反するDELETE HTTPアクション、として渡された情報を複製するため

---

かかわらず、RESTfulなの定義の、私の意見では、TutorialsPointは、間違ったデザインを発表しました。

Answer 1

エンドポイントの最初のセットは、REST APIのための悪いデザインです。それはすべてRPCに関するものです（そして、DELETEリクエストはペイロードを持つべきではありません）。

エンドポイントの2つ目のセットはリソース指向のであり、これはREST APIで必要なものです。 URIはリソースを識別し、HTTPメソッドはリソースに対する操作を表します。

---

ただし、RESTアーキテクチャはURI設計をはるかに超えています。

RESTアーキテクチャスタイルはプロトコルに依存しませんが、ほとんどの場合、HTTPプロトコルで設計されています。

RESTfulアプリケーションの基本的な概念は、リソースです。また、リソースはさまざまな表現を持つことができます。詳細については、answerを参考にしてください。

• Client-server
• Stateless
• Cache
• Uniform interface
  ：

  がRESTfulなと見なされるために、アプリケーションは、ロイ・トーマス・フィールディングの論文のchapter 5で定義された一連の制約に従わなければなりません

  • リソースの識別
  • リソース表現上の
  • 自己記述のメッセージ
  • ハイパーメディア
• Layered system
• Code-on-demand

Answer 2

はい、あなたの理解は正しいです。そのチュートリアルは誤解を招く。