imporve api.rst

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