improved api.rst

A few sentences appear both in the preamble of "API basics" and the "Using the HTTP API" Section.