(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.
Maybe you could list here what default options would be applied for values if this form of the constructor is called.