Update API.md

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