3 ms·
If I'm operating a Frobnitz service and my documentation doesn't indicate how to Blat a given Frobnitz, then the failing isn't my communication layer, it's my d
by generalk 17y ago
If I'm operating a Frobnitz service and my documentation doesn't indicate how to Blat a given Frobnitz, then the failing isn't my communication layer, it's my documentation.
- billpg 17y agoIn my little thought experiment, I'm implementing the interface to the blatting service.
- blasdel 17y agoNo! REST begs you not to have any separate documentation that is mandatory to understand your API. The response from the Frobnitz resource should contain hypertext that indicates how to Blat it: at least the method and url.
- generalk 17y agoBoth are good! Documentation helps ease users in, while proper hyperlinks make the service discoverable.