This is the first release of JSON API 2.x 🎉

Unlike many module major version bumps, 2.x does not mean that we rewrote the module! In fact, we've increased the stability of this module 💯🤘💥

So, why has the major version been bumped? While making the module more specification compliant, and while adding more tests, and while covering more edge cases, we ran into a few things that we couldn't make better without breaking some things...

What did we break? Well, we've tried very hard to document each and every change. 90% of JSON API clients won't need to change anything, BC was only broken in edge cases. We think you'll be okay with them 🙏 and we're pretty confident that the most disruptive changes have a relatively simple upgrade path. BUT, we could be wrong 😱 and that's what this beta is for! The most disruptive change is probably that Drupal's UNIX timestamps are now exposed as ISO timestamps via JSON API.

We know what you're thinking, "alright, you've convinced me!" So, when and if you do find breaking changes that aren't documented in the change records, please let us know by filing an issue. If you're having trouble figuring out how to upgrade, please file a "support request" so that we can improve the change record with more thorough instructions. We're happy to help you, if you'll help us find those cases 😘

We've also documented the two new features that are already in this beta:

Entities that you are not allowed to view, but you are allowed to view the label of are no longer omitted; instead you can only see their label! the new meta.links.me entry provided by /jsonapi which links to the current user

And for those of you thinking, "oh man, I just can't upgrade right now", we've tried to think of you too 🤗. JSON API 1.22 marked the beginning of a "critical support" phase for the 1.x branch. We'll do our best to backport any security fixes and/or critical bugs affecting all users to the 1.x branch for a while yet.

We hope you love JSON API as much as we do. Please consider filing an "experience report" in the issue queue to tell us how you're using it or what you've built with it, especially your successes! Believe it or not, we seem to only see your problems! ¯\_(ツ)_/¯

❤️❤️❤️

- The JSON API Maintainers 👚

Summary: 8.x-2.0-beta1

Contributors: (21) Wim Leers, e0ipso, gabesullice, hampercm, clemens.tolboom, dawehner, gargsuchi, justafish, sonnykt, alexpott, jlscott, DavidSpiessens, BR0kEN, danielnv18, drpal, martin107, effulgentsia, webchick, balsama, nileshlohar, garphy

Issues: 49 issues resolved.

Changes since 8.x-1.22:

Bug

Feature

Task