Back to News
Advertisement
Advertisement

⚡ Community Insights

Discussion Sentiment

33% Positive

Analyzed from 246 words in the discussion.

Trending Topics

#rest#api#didn#restful#term#opposite#json#else#terminology#real

Discussion (5 Comments)Read Original on HackerNews

pornelabout 1 hour ago
The terminology confusion was too difficult to resolve.

"REST" became associated with a good API design, so when people were told their API isn't a real REST, they interpreted it as having to implement more of Roy Fielding's vision to make it a really good API.

"Real REST must be self-describing hypermedia!" sounded like "you have to add more hyperlinks and delete your API docs", which of course didn't make any sense when you already had a thick RPC client (and RPC may have been the right architecture for the API).

"RESTful" was too similar to be a term for the opposite of the original REST, so it was too easy to interpret the issue as a technical criticism of "RESTful" being weak and falling short of fully-featured ideal "REST" rather than a terminology problem of the same term used for two valid but opposite architectural approaches.

The other term used at that time was AJAX ("async JS and XML"), which made even less sense for the "sync PHP and JSON" APIs (Node.js didn't exist yet).

JoeBOFHabout 3 hours ago
To me this is gif vs gif. The populous has shifted in a direction the originator didn’t intend, but it’s the populous that use it.

RESTful to me is HTTP calls with PUT/PATCH/GET/DELETE and whatever else I am missing. The return doesn’t need to be json but needs to be structured so XML, JSON, etc

commandlinefanabout 2 hours ago
Part of the nomenclature problem here is that there's no other way to refer to an HTTP-based API. REST was originally an alternative to the horrible SOAP. I'd be fine with calling it something else (because the author is right, nobody's following Fielding's vision), but there's nothing else to call it.
krystalgamerabout 3 hours ago
this is explained in the article... referred to as Level 2 of Richard Maturity Model.

"Everyone stopped at Level 2 of the RMM"

commandlinefanabout 2 hours ago
Agile definitely means the opposite of agile.