Repository files navigation

DO NOT USE THIS PACKAGE FOR NEW PROJECTS - USElaravel-json-api/laravelINSTEAD.

This package has now been rewritten, substantially improved and released as thelaravel-json-api/laravel package.Documentation for the new version is available on our new websitelaraveljsonapi.io and thecode is now developed under theLaravel JSON:API Github organisation.

Thecloudcreativity/laravel-json-api package is now considered to be thelegacy package. As we know it is in use ina lot of production applications, it will continue to receive bug fixes and updates for new Laravel versions. However,it is no longer supported for new features.

If you are starting a new project, you MUST use thenew packagelaravel-json-api/laravel.

Build feature-rich and standards-compliant APIs in Laravel.

This package provides all the capabilities you need to addJSON APIcompliant APIs to your application. Extensive support for the specification, including:

• Fetching resources
• Fetching relationships
• Inclusion of related resources (compound documents)
• Sparse fieldsets.
• Sorting.
• Pagination.
• Filtering
• Creating resources.
• Updating resources.
• Updating relationships.
• Deleting resources.
• Validation of:
  • JSON API documents; and
  • Query parameters.

The following additional features are also supported:

• Full support for Eloquent resources, with features such as:
  • Automatic eager loading when including related resources.
  • Easy relationship end-points.
  • Soft-deleting and restoring Eloquent resources.
  • Page and cursor based pagination.
• Asynchronous processing.
• Support multiple media-types within your API.
• Generators for all the classes you need to add a resource to your API.

Fromjsonapi.org

If you've ever argued with your team about the way your JSON responses should be formatted, JSON API is youranti-bikeshedding weapon.

By following shared conventions, you can increase productivity, take advantage of generalized tooling, and focus onwhat matters: your application. Clients built around JSON API are able to take advantage of its features aroundefficiently caching responses, sometimes eliminating network requests entirely.

For full information on the spec, plus examples, seehttp://jsonapi.org.

Full package documentation is available onRead the Docs.

Join the Laravel JSON:API community onSlack.

Make sure you consult theUpgrade Guidewhen upgrading between major or pre-release versions.

Apache License (Version 2.0). Please seeLicense File for more information.

Installation is viacomposer. See the documentation for complete instructions.

Contributions are absolutely welcome. Ideally submit a pull request, even more ideally with unit tests. Please note thefollowing:

• Bug Fixes - submit a pull request against themaster branch.
• Enhancements / New Features - submit a pull request against thedevelop branch.

We recommend submitting an issue before taking the time to put together a pull request.