(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.
Might be nice to have the example include the construction of the client as well.  Helps for quick copy/paste to your own code.