(TK-117) Add external API docs

Add some external API docs in the doc folder which detail how
to make requests using the Java and clojure clients.
I think it would be good to provide links to the actual javadocs for all these classes, and we could probably get rid of some of the text that talks about what the inputs/outputs are and replace them with links to the corresponding constructor/method javadocs.