v6.4 with angular and RAD (Swashbuckle version v4.x needs server side template changes) #6321

AidanCostcoAU created 5 years ago

Hi,

We just learnt that Swashbuckle v4 no longer builds unique OperationId's in the swagger Json. Previously the operationid was a concatentation of the uri, method, and http type.

The RAD tool is still generating operation names which are not unique (such as GetAll, Delete etc), so these now flow through to non-standard swagger json, which cannot be consumed by other tools.

I can override templates, but please update the base templates.

for existing/regen I should offer some options:

generate globally unique method signatures (but will break existing API clients)
leave the method signatures the same, but add the swashbuckle aware annotations which render the published operationid as unique - I think this might allow compatibility with existing API clients
implement a swashbuckle document processor to achieve the unique operationid's

thanks

v6.4 with angular and RAD (Swashbuckle version v4.x needs server side template changes) #6321

1 Answer(s)