On: Rules for REST API URI Design

[rdsubhas]

Spot on. RESTful URLs are not to be treated like SEO URLs. But unfortunately most people don't see the difference. One example in the article is especially harmful (/students/<id>/courses/physics for querying).

The single best slideshare I've found on REST is Teach a Dog to REST. Old but gold. https://www.slideshare.net/landlessness/teach-a-dog-to-rest

(And a shameful plug - https://medium.com/@rdsubhas/pitiful-restful-urls-5d576ffccb...)

[rimliu → rdsubhas]

  > RESTful URLs are not to be treated like SEO URLs

But it does not hurt to have them human-readable.

[rdsubhas → rimliu]

It does hurt. Examples in the article linked above.

[barrkel → rdsubhas]

Most web apps (outside of websites themselves, which are a kind of very simple application) aren't HATEOAS, so Roy's thesis has less purchase on their design.