From the beginning of the conception of our simplest ReST APIs, we have to make lots of important choices and we feel like kids at “Tous R Us”.
Why are these choices so important?
After all, we could think that a good documentation would be enough.
The problem is that we will soon meet some barriers with libraries, frameworks and connectors that are highly based on ReST conventions.
Even better than conventions, we would need a standard that covers most of the following points:
Data exchange format.