add note to require api, fixes #1732
Prefer DYNO name over system hostname on Heroku, fixes #1742