Awesome
JSONAPI::Resources
JSONAPI::Resources
, or "JR", provides a framework for developing an API server that complies with the
JSON:API specification.
Like JSON:API itself, JR's design is focused on the resources served by an API. JR needs little more than a definition of your resources, including their attributes and relationships, to make your server compliant with JSON API.
JR is designed to work with Rails 5.1+, and provides custom routes, controllers, and serializers. JR's resources may be backed by ActiveRecord models or by custom objects.
Documentation
Full documentation can be found at http://jsonapi-resources.com, including the v0.10 alpha Guide specific to this version.
Demo App
We have a simple demo app, called Peeps, available to show how JR is used.
Client Libraries
JSON:API maintains a (non-verified) listing of client libraries which should be compatible with JSON:API compliant server implementations such as JR.
Installation
Add JR to your application's Gemfile
:
gem 'jsonapi-resources'
And then execute:
bundle
Or install it yourself as:
gem install jsonapi-resources
For further usage see the v0.10 alpha Guide
Contributing
- Submit an issue describing any new features you wish it add or the bug you intend to fix
- Fork it ( http://github.com/cerebris/jsonapi-resources/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Run the full test suite (
rake test
) - Fix any failing tests
- Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Did you find a bug?
-
Ensure the bug was not already reported by searching on GitHub under Issues.
-
If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a title and clear description, as much relevant information as possible, and a code sample or an executable test case demonstrating the expected behavior that is not occurring.
-
If possible, use the relevant bug report templates to create the issue. Simply copy the content of the appropriate template into a .rb file, make the necessary changes to demonstrate the issue, and paste the content into the issue description or attach as a file:
License
Copyright 2014-2021 Cerebris Corporation. MIT License (see LICENSE for details).