Added initial documentation of the JSON API

Please discuss on this proposal.
You messed up singular vs. plural here.