imporve api.rst

A few sentences appear both in the preamble of "API basics" and the
 "Using the HTTP API" Section.
Merge pull request #15 from scrapinghub/shuai-fix

improved api.rst