mirror of
https://github.com/ditkrg/jsonapi-swagger.git
synced 2026-01-22 22:06:50 +00:00
49 lines
1.1 KiB
Markdown
49 lines
1.1 KiB
Markdown
# JSONAPI Swagger
|
|
|
|
Generate JSONAPI Swagger Doc.
|
|
|
|
[](https://rubygems.org/gems/jsonapi-swagger)
|
|
[](https://github.com/superiorlu/jsonapi-swagger/blob/master/LICENSE)
|
|
|
|
[](https://i.loli.net/2019/05/05/5ccebf5e782b7.gif)
|
|
|
|
## Installation
|
|
|
|
Add this line to your application's Gemfile:
|
|
|
|
```ruby
|
|
gem 'jsonapi-swagger'
|
|
```
|
|
|
|
And then execute:
|
|
|
|
$ bundle
|
|
|
|
Or install it yourself as:
|
|
|
|
$ gem install jsonapi-swagger
|
|
|
|
## Usage
|
|
|
|
```sh
|
|
rails generate jsonapi:swagger User # UserResponse < JSONAPI::Resource
|
|
```
|
|
|
|
## RoadMap
|
|
|
|
- [x] immutable resources
|
|
- [x] filter/sort resources
|
|
- [x] mutable resources
|
|
- [ ] generate swagger.json without rswag
|
|
|
|
## Resource
|
|
|
|
- [JSONAPI](https://jsonapi.org/)
|
|
- [JSONAPI::Resources](http://jsonapi-resources.com/)
|
|
- [Rswag](https://github.com/domaindrivendev/rswag)
|
|
|
|
## Contributing
|
|
|
|
Bug reports and pull requests are welcome on GitHub at
|
|
https://github.com/superiorlu/jsonapi-swagger.
|