(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 reword this to "The `create-client` function takes one argument, a map called `options`.