JSON API v1.0 support

Open
#271 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
20/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Stale
Tech stack
ruby
Domain
api, documentation

Research direction

Start by tracing how Grape::Entity and Grape Swagger generate the request parameters and response model shown in Swagger UI. Compare that output with the JSON API v1.0 nested relationships example; done means Swagger UI represents nested attributes and relationships rather than only a flat attribute list.

Written by the indexing model from the issue text.

Description

needs help swagger-1.2

Hi.

I'm planning to use JSON API v1.0 standard with Grape API + Grape Entities + Grape Swagger in my project, but unfortunately I couldn't manage to make it work.

I've stumbled upon an issue that I cannot create nested attributes. The result I'm trying to achieve should look like so:

{
  "links": {
    "self": "http://example.com/posts",
    "next": "http://example.com/posts?page[offset]=2",
    "last": "http://example.com/posts?page[offset]=10"
  },
  "data": {
    "type": "posts",
    "id": "1",
    "attributes": {
      "title": "JSON API paints my bikeshed!"
    }
    relationships: {
      author: {
        data: {
          id: 1,
          type: 'users'
        }
      }
    }
  }
}

Is it even possible with Grape::Entity + Grape Swagger?

Forgot to mention, Swagger UI just shows flat list of attributes in both request parameters section and response model.

Dominant language
Ruby
Stars
1.1k
Forks
479
Avg merge
2d 14h
Merged PRs (30d)
6

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from ruby-grape/grape-swagger

All issues in ruby-grape/grape-swagger

Similar issues

More Ruby issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.