MagicOnion VS Swashbuckle.AspNetCore.Filters

If you're in dotnet land, I'd recommend poking magic onion [0] or messagepack. It'll be much nicer to work with once you have a decent pile of message types. Otherwise it's easy to end up in an entity framework like situation where you're constantly serializing and deserializing, generating serializer wrappers, etc. Although any of the cysharp libs are great in dotnet, definitely recommend checking out their back catalogue.

[0] https://github.com/Cysharp/MagicOnion

Having used it on a previous project, I found maintaining the protocol buffers quite tiresome. However, if I wanted to use it again, I'd be inclined to look into the MagicOnion project, which, in its own words:

MagicOnion? https://github.com/Cysharp/MagicOnion

BUT if you absolutely need to change the exposed Open API specification, assuming you are using Swashbuckle, look for operation/schema filters (here), you can modify all aspects of generated specification this way.

// Enable the default method attributes c.EnableAnnotations(); // Add the SwaggerResponseHeader attribute (look at a controller call that returns pagination info) c.OperationFilter(); // The following three lines define trigger generation of security info within the swagger.json // https://github.com/mattfrear/Swashbuckle.AspNetCore.Filters#security-requirements-filter c.OperationFilter(); c.OperationFilter(); c.AddSecurityDefinition("oath2", new OpenApiSecurityScheme() { Description = "Standard authorization using bearer scheme. Ex: \"bearer {token}\"", In = ParameterLocation.Header, Name = "Authorization", Type = SecuritySchemeType.ApiKey }); // Main app definition c.SwaggerDoc("v1", new OpenApiInfo { Title = "The awesome API", Version = "v1", Description = "The Awesome API V1" }); // Look at XML comments and pull summaries and examples into the swagger.json // Note: the csproj file must be edited to generate teh xml documentation files var xmlFiles = Directory.GetFiles(AppContext.BaseDirectory,"*.xml",SearchOption.TopDirectoryOnly).ToList(); xmlFiles.ForEach(xmlFile => c.IncludeXmlComments(xmlFile));