Search code examples
apiresturl-design

Which one of the following is a better Rest URL?

Just a quick question. Which one of the following makes a better Rest API Url & why so?

  1. GET shop/department/{id}/{action}
  2. GET shop/department/{action}/{id}

The action is a verb and it can be:

  • GET shop/department/{id}/download
  • GET shop/department/{id}
  • GET shop/department/{id}/receive
Solution

  • If action is an action as in Remote Procedure Call RPC, both are equally bad.

    Actions don't belong in URLs but in HTTP verbs.