That's part of my reasoning. Setting proper headers is, yes, more proper... and something essentially nobody does, and many simple API libraries don't support without making using them massively more complicated than prefixing all the URLs with "api/2".

It's a correctness vs usability debate. I'd love to go for correct, but it's extremely painful to enforce in your users in practice.