The difference between a good API and a great API is largely down to the behaviour in the dark murky corners.