Update API.md

Can bluebird guarantee that the resolver function is called synchronously or not?  Document the guarantees.
Merge pull request #294 from alexanderkjeldaas/patch-1

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