Having the API definitions in a separate module makes it easier to build clients without duplicating code. It also makes it harder to introduce bugs due to mismatching paths, parameters etc.