News for hackers. Stuff that matters.
Re:Swagger: A simple, open standard for describing REST APIs... by chubot on Tuesday March 27, 2012 @03:49AM (#3760515)
That's the theory... but the gaping hole is that JSON doesn't define hyperlinks like HTML does. Also, I think Subversion tried to make resources discoverable from the root with WebDAV, but it just leads to crazy latency with all the round trips, and everyone agrees it was a mistake.

Any APIs you can point to that actually use "hypermedia" and are successful? Most good APIs I've seen just define a bunch of simple JSON endpoints with predictable URLs.

Re:Swagger: A simple, open standard for describing REST APIs... by jcromartie on Tuesday March 27, 2012 @08:28AM (#3761103)