Update API.md wrt guarantees given by "new Promise"

Can bluebird guarantee that the resolver function is called synchronously or not?  Document the guarantees.