While I disagree with the first ”sign“, the rest is pretty good
5 Signs That Your REST API Isn't RESTful. Reminds me of when I had a "Certified SOA" rubber stamp as a joke. dzone.com/articles/5-easy-to…

Dec 6, 2016 · 9:02 PM UTC

4
7
6
Replying to @stilkov
Item 4. is rather misleading. The same rationale could be applied to plain URIs, which clearly are not a problem @jevdemon
1
Why? The (correct) reasoning seems to be: Exchange URIs and URI recipes a.k.a. templates in HTTP messages, not docs
1
Replying to @stilkov
not sure about the version 'sign' as a lot in API versions is not about representation but about a business concept changing
Replying to @stilkov
I disagree with 2. The id of a product ist typically not defined by a REST API so I wouldn't change it there. 1/2
Replying to @stilkov
If you want to add a link to the representation, add a link. 2/2