JSON API is a decent choice in its basics but has gaps (no file-upload standard) and imperfect Ruby libraries. Sticking with it religiously is a bad idea — apply it with your own exceptions and be open-minded about alternatives like GraphQL for use cases where JSON API falls short.