(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'll go ahead and add the Javadocs in this PR once I've addressed all the other feedback.