How does a Programmer know what to Post?
No good answer.
What Restafarians mean by an API description is meager.
- The API is Get/Put/Post/Delete
- There is no requirement to describe the possible arguments of
these anywhere.
- There is no standard specification of how to do so were there.
The programmer just has to read the text documentation.
This is indeed simpler and faster than WSDL/SOAP for simple
services. But it is then just another kind of RPC.
REST does not fit our definition of web service.
There is no machine-readable description including at least
the inputs and outputs for the service.
©2012
Charles Petrie - permission to reproduce widely with attribution.