You can combine both sometimes in application logic.

Some API:s can be perfect. But then the real world adaptation needs to happen inside the module serving the API.