Spring Guides

Understanding REST

• GET
  • idempotent
  • regardless of how many times it repeats with the same parameters, the results are the same.
• PUT
  • idempotent
  • can create a new entity or update an existing one.
  • eg. PUT /addresses/1
• POST
  • non-idempotent
  • repeated POST calls to /users in this case will create multiple users, which is a different end result.
• DELETE
  • actually non-idempotent

HTTP status code

1XX - informational

2XX - success

3XX - redirection

• 301 Moved Permanently: This and all future requests should be directed to the given URI.

4XX - client error

5XX - server error