added documentation on http API