Accurate OData response schema about swashbuckle.odata HOT 7 CLOSED

I was thinking about this too the other day, that the response model is not accurate. Its been good enough for human use but is probably not good for tooling use.

from swashbuckle.odata.

This is basically a bug: the response model should be accurate. I'll handle it.

from swashbuckle.odata.

@joshbooker Out of curiosity, what tools are you using against the swagger json?

from swashbuckle.odata.

Mostly Azure App Service Logic Apps. An OData project can be published as an API App then used as a custom connector in Logic Apps. The Logic Apps tooling reads swagger response schema and builds expressions against the json response. The current schema works great as the tooling displays a list of Order properties. The problem is, the tooling doesn't know the Orders array is wrapped in a value array. When manually edit expressions in code view of logic app designer I can successfully include .value - just the tooling doesn't do it for me. It tried to change the response schema in an Operation Filter as a test, but couldn't figure it out.

Additionally I've used swaggerhub.com and editor.swagger.io. They don't really act on response schema, so they're not really affected by this particular problem. They do show the response model so they were helpful in determining the suggested sample response schema in my post above.

Off topic: These tools have other issues. I cannot send a request because they include unused parameters in the URI. (/Orders?$expand=&$filter=&etc) OData doesn't like that. I tried including the swagger allowEmptyValue = false (which should be the default) but that had not affect. I'm of the opinion that they should leave off unused params like the swagger UI does. If anybody has any ideas here I'd like to know.

Anyway thanks for your hard work.

from swashbuckle.odata.

Oh yeah, also I noticed I'm not getting default error response schemas. I think the original OData swagger utilities was including these, but they got lost somewhere here. Pretty sure most tools will be happier having a default response to catch error message.

from swashbuckle.odata.

The response model is now correct for collections in v2.10.1. Please give it a try. An error response model will be an enhancement; please create a separate ticket for this. Thanks!

from swashbuckle.odata.

Thanks. Works Great! Error response issue here: #51

from swashbuckle.odata.