(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.
Similar comment here about documenting the need to call `close` when finished with the client as for the corresponding function in the Clojure API.