Integration with Swashbuckle / Swagger

[jaredcnance]

Several users have requested this feature but have hit errors such as:

I get System.Reflection.AmbiguousMatchException: Ambiguous match found. when I include a JSONAPIController

Does the MediaTypeHeaderValue get set automatically? I'm use Swashbuckle and all of the generated "code" is only allowing for application/json (i.e. not vnd.api+json)

[crfloyd]

I currently have Swashbuckle working with this library using a JsonApiController. I think the AmbiguousMatch exception arises when you override a base controller method without providing an http action attribute. I'm currently attempting to use the swaggerGen file to try to create a client library but running into issues exposing the jsonapi document model as the response model.

[wayne-o]

That would make sense - I'll have a look and see if this relates to my issue

…

On Wed, 18 Apr 2018 at 15:58 Corey Floyd ***@***.***> wrote: I currently have Swashbuckle working with this library using a JsonApiController. I think the AmbiguousMatch exception arises when you override a base controller method without providing an http action attribute. I'm currently attempting to use the swaggerGen file to try to create a client library but running into issues exposing the jsonapi document model as the response model. — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#259 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAK3jHxkgJQx8LBSY3llGvaspvKMQ8-4ks5tp1SAgaJpZM4TWn9H> .

[crfloyd]

@jaredcnance I am currently working on a way to expose an OpenAPI schema for my webservice like SwaggerGen does except that it creates the correct resource document models and all the required attribute and relationship child models that go with it. It is my hope to create an OpenAPI-complient schema doc that can be used by AutoREST to create a client to consume any api using this library. If this is something you would like integrated once I complete it, I'd be happy to issue a pull request for it.

[jaredcnance]

@crfloyd that sounds fantastic. Let me know if there is anything I can do to help you.

[crfloyd]

I spent most of last week working on this and I currently have an OpenAPI 3.0 schema generating off the JsonAPIContext using Microsoft.OpenApi. It exposes paths for all the controller actions with full document responses where required. I have it in a separate project and exposed via a core Middleware. If this is something you would like to include by default in your library or via opt-in during registering the JADNC middleware, I'd like to hear your ideas on the best way to integrate with the existing library.

[jaredcnance]

@crfloyd that sounds awesome. If you can share your project I’d love to play around with it some this week and get a feel for it. Depending on the surface area and dependencies, I could see an argument for either including it in the library directly or as a bolt on package.

[crfloyd]

Sounds good. I will shoot a pull request your way. I have attached an example openapi.yaml file generated by the project based on a super simple API with a student and course model. The library walks the context graph and creates resource names and comments based on what is registered there. I am still playing with the best way to include the filter,sort,page,include params for the Get requests.

openapi.zip

[crfloyd]

I had to go with OpenAPI 3.0 as 2.0 does not support DeepObject which is required for the filter[name]=foo type query params. Its a netstandard library and the only project dependencies are JsonAPIDotnetCore, Microsoft.OpenAPI and Humanizer for correct naming of things.

[lheiskan]

@crfloyd - this sounds very useful, are you still working on this?

[wayne-o]

What's the situation with this? Has anyone tried more recently?

[CoolGoose]

Bump-ing this since i would like to help @crfloyd

[jeff-becker-projekt202]

I've got a bunch of code that deals with this that my company uses internally. Once i get some down-time we'd be glad to contribute it back