On: How to Version an API

[paulddraper]

> RESTful. It should speak the language of HTTP verbs: GET, PUT, POST, PATCH, UPDATE, DELETE

What in the heck is UPDATE? It sounds like a non-technical person found out REST had CRUD.

[itcmcgrath → paulddraper]

It's the verb you use when you want to receive a 400 with "BAD Request - Invalid verb"

[jholman → paulddraper]

There's nothing RESTful about using more than 2 HTTP verbs (GET for SAFE endpoints, and POST for UNSAFE ones). (Mind you, REST does require that you obey the semantics of HTTP for the verbs that you do use, standard or non-standard).

And then the API endpoints illustrated don't obey HATEOS. So there's nothing RESTful about the article either.

[jalfresi → paulddraper]

You can define your own HTTP verbs if you want

[abraae → paulddraper]

But failed to also add INSERT.