Amending api token section of README

The section of the README that covered using the VCloud API token
was not complete. I've added additional details that should make it
easier to use.
Reword session token introductory paragraph

Based on alphagov/vcloud-tools#187 and done in consultation with
@danielabel