Revise API docs in README
Revise API docs in README

This removes references to the (now deleted) Dev VM, and merges the
API documentation and examples together.

alphagov/asset-manager,alphagov/asset-manager,alphagov/asset-manager