3 ms·
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 define
by smhinsey 15y ago
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.
- jcromartie 15y agoYes, 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.