Install
Works with Drupal: 8.xUsing Composer to manage Drupal site dependencies
Alternative installation files
Release notes
This the first release candidate for JSON API 2.0!
The JSON API maintainers strongly believe that this version will suffer absolutely no further breaking changes before the final stable release of JSON API 2.0. 2.x is the version which is proposed for inclusion in Drupal core. In other words, the only changes to the 2.x branch from this point forward will be bug fixes, stability improvements and new features.
A release candidate means that it is your last chance to find and report issues which might cause BC breaks! It's now or never!
If you've already built on top of JSON API, now is the time to start migrating to 2.0! 1.x support will only last for so long after 2.x is released. Every breaking change since the 1.x branch has been listed on the JSON API change records page. It is highly unlikely that you will be affected by more than a handful of them.
If you're considering building with JSON API, you should feel confident using this release in your application. The risk of building upon an unstable footing is now all but eradicated.
Contributors (8)
Wim Leers, gabesullice, e0ipso, jludwig, pixelwhip, abhisekmazumdar, izus, Mile23
Changelog
Issues: 16 issues resolved.
Changes since 8.x-2.0-beta2:
Bug
- #3007113 by Wim Leers, gabesullice: Follow-up for #2977669: denormalizing aliased relationships fails
- #3005826 by jludwig, Wim Leers: Follow-up for #2984964: JSON API + hook_node_grants() implementations: count queries still result in cacheability metadata leak
- #2986900 by Wim Leers, e0ipso, gabesullice: Unnecessary asserts break installation in distros that include JSON API
Task
- #3008544 by Wim Leers, gabesullice: Use \Drupal\serialization\Normalizer\CacheableNormalizerInterface::SERIALIZATION_CONTEXT_CACHEABILITY
- #3005999 by gabesullice, Wim Leers, e0ipso: Revision ID should be `drupal_internal__vid`
- #3006743 by Wim Leers: Follow-up for #2624770: EntityConverter service requires additional parameters since Drupal core 8.7
- #3006270 by Wim Leers: Add ResourceTypeRepository::createResourceType() for easier JSON API Extras support and simpler code
- #2946537 by Wim Leers, gabesullice, pixelwhip: Test coverage: Inclusion of intermediate resources when include is a multi-part relationship path
- #2956084 by gabesullice, Wim Leers: Impossible to raise an error when an `include` is requested for an inaccessible relationship field
- #3003148 by abhisekmazumdar, gabesullice, izus: README should point to jsonapi.api.php and online documentation
- #2991841 by gabesullice, Wim Leers: Remove unused parameters from EntityResource methods
- #2987610 by gabesullice, Wim Leers: Remove RequestHandler class and service and add EntityResource methods to each route definition
- #2987608 by gabesullice, Wim Leers: Move deserialization from RequestHandler to JsonApiParamEnhancer
- #3001564 by gabesullice, Wim Leers: Follow-up to #2997600: Clean up dead code paths
- #3001958 by Wim Leers, gabesullice, Mile23: 4 test fails due to using deprecated code on 8.6 and 8.7 since #2996789: temporarily fork the test trait