(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.
Same comment here as for the Clojure client.  Might be nice to include the call to construct the client as the first line in the example for easy copypasta.