(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.
General comment for these - I'd be inclined to just take "@author" out.  Not sure that it serves all that much value anyway after enough people have been contributing to the code over time.  Also, we don't do this anywhere in the Clojure-level code today.