Re:Swagger: A simple, open standard for describing REST APIs...
by smhinsey on Monday March 26, 2012 @09:25PM
(#3759500)
I think when done right (a subjective measurement, to be sure) the only URI you care about for a RESTful API is the root, because the API's resources are defined, along with how they can be manipulated, in the root response or can be transitioned to from there in some way that is defined there.
Re:Swagger: A simple, open standard for describing REST APIs...
by jcromartie on Monday March 26, 2012 @10:24PM
(#3759673)
Yes, that's the key. If the media types are documented (like how browsers and developers understand HTML forms) then you don't need to document every single corner of the API. You can offer a good definition of the media types, and let the resources and links do the rest.
See: http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hyperte...