Feature request: Add support to JSON:API as a schema type

[swilgosz]

Is your feature request related to a problem? Please describe.

We are developing our API collections using JSON:API standard and we would love to create a new API in Postman for finished Services.

However, currently, we can only choose OpenAPI, RAML or GraphQL as schema types. There is no JSON:API nor even the custom one.

Describe the solution you'd like

Ideally, add an option to choose JSON:API standard as a schema type

Describe alternatives you've considered

Delivering the custom option possibly could work.

Additional context

Basically, we cannot use the whole APIs feature with our chosen API schema.

[n2ygk]

JSON:API can be described by OpenAPI 3.0 -- well, with one bug fix in the OpenAPI spec which is coming in the 3.1 release having to do with JSON:API requiring the DELETE method to have a request body.

For example, Django-REST-Framework-JSON-API release 4.0 now has an initial implementation of automatic JSON:API schema generation based on the serializer definitions. Please use (improve!) the components boilerplate from that code as a start!

I've successfully imported an OpenAPI 3.0 spec generated by this code into Postman. There's one Postman bug (#9053) that appears to have been closed in error having to do with representing deepObject.

I hope this helps.