Add jsonapi.org compliant APIs to your Laravel 5 application. Based on the framework agnostic packages neomerx/json-api and cloudcreativity/json-api.
From jsonapi.org
If you've ever argued with your team about the way your JSON responses should be formatted, JSON API is your anti-bikeshedding weapon.
By following shared conventions, you can increase productivity, take advantage of generalized tooling, and focus on what matters: your application. Clients built around JSON API are able to take advantage of its features around efficiently caching responses, sometimes eliminating network requests entirely.
For full information on the spec, plus examples, see http://jsonapi.org
A demo application is available at here.
We use semantic versioning but Laravel does not. This table will help...
| Laravel | This Package |
|---|---|
| 5.3.* | ^0.9 |
| 5.4.* | ^0.10 |
Make sure you consult the Upgrade Guide when upgrading.
Currently we have not integrated the package with Lumen. If you use Lumen and can help, please let us know on this issue.
Documentation is available on Read the Docs.
This repository is under development. We have production applications that are using the package and extensive test coverage of these applications.
We are aiming for v1.0 as soon as possible. See this issue for progress.
Apache License (Version 2.0). Please see License File for more information.
Installation is via composer. See the wiki for complete instructions.
Contributions are absolutely welcome. Ideally submit a pull request, even more ideally with unit tests. Please note the following:
- Bug Fixes - submit a pull request against the
masterbranch. - Enhancements / New Features - submit a pull request against the
developbranch.
We recommend submitting an issue before taking the time to put together a pull request.