Gabe, Mateu and I just released the second RC of JSON:API 2, so time for an update! The last update is from a month ago.
What happened since then? In a nutshell:
- Usage has gone up a lot! 2.0-RC1: 0 → 250, 2.x: ~200 → ~330 1
- 2.0-RC2 released 🙂
- RC1 had about half a dozen issues reported. Most are fixed in RC2. 2
- The file uploads feature: 80% → 100%, will ship in 2.1!
- The revisions feature: 80% → 90%
- New core patch to bring JSON:API to Drupal core: #2843147-78
Curious about RC2? RC1 → RC2 has four changes:
- Renamed from
JSON:API, matching recent spec changes.
- One critical bug was reported by brand new Drupalist Peter van Dijk (welcome, and thanks for noticing something we had gotten used to!): the
?filtersyntax was very confusing and effectively required the knowledge (and use) of Drupal internals. Now you no longer need to do
/jsonapi/node/article?filter[uid.uuid]=c42…e37to get all articles by a given author, but just
/jsonapi/node/article?filter[uid.id]=c42…e37. This matches the JSON:API document structure: the abstraction is no longer leaky! The updated
?filtersyntax is still 95% the same. 3
- JSON:API responses were no longer being cached by Page Cache. This was of course a major performance regression. Fortunately long-time Drupalist yobottehg discovered this!
- Massive performance increase for requests using sparse fieldsets such as
?fields[node--article]=title. Thanks to long-time Drupalist jibran doing quite a bit of profiling on JSON:API, something which Mateu, Gabe and I haven’t gotten around to yet. Moving 2 lines of code made his particular use case 90% faster! We’re sure there’s more low-hanging fruit, but this one was so tasty and so low-risk that we decided to commit it despite being in RC.
So … now is the time to update to 2.0-RC2!
The JSON:API team: 150/150/150
In the previous update, I included a retrospective, including a section about how it’s been to go from one maintainer to three. A month ago this happened:
https://usercontent.irccloud-cdn.com/file/REdyLpD6/2018-10-24%2011-07-42.png 11:08:27 Let's get that to 150, 150 and 150 11:08:31 :D 11:08:46 that'd be pretty cool indeed 11:09:05 COMEON gabesullice you're slacking! 11:09:08 hehe
That image was:
Well, as of yesterday evening, it looks like this:
On top of that, mere hours after previous update went live, Gabe became an official API-First Initiative coordinator, together with Mateu and I:
This is up there at the top as one of my proudest Drupal moments 🙂
— Gabriel Sullice (@GabeSullice) October 25, 2018
Congrats Gabe, and thanks! 🙂
Note that usage statistics on drupal.org are an underestimation! Any site can opt out from reporting back, and composer-based installs don’t report back by default. ↩︎
Since we’re in the RC phase, we’re limiting ourselves to only critical issues. ↩︎
This was not a regression in 2.x; this also affects JSON:API 1.x! It’s just more apparent in 2.x that this is a problem because we did make 2.x comply with the spec completely (which also was the reason for the 2.x branch: we needed to break backward compatibility to comply). We chose to embrace the feedback and introduce this additional BC break in the 2.x branch. Some of your requests will now return 400 responses, but they all include helpful error messages, providing concrete suggestions on how to change it. ↩︎