(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.
@camlow325 I felt it would be good to not document those, as I don't think a user of this library should ever be manually creating a Response object themselves.