added api documentation of http-lib

done for [AGIOS-273](https://issues.jboss.org/browse/AGIOS-273)