Alter parameter name for Swagger JSON generated through Swashbuckle in .NET Web API 2

Question

Goal: I am designing a REST API that allows user to pass parameters on the query string for an HTTP GET request. Something like

http://fake.api.com/search?api-key=1235&term=car&rows=10

Implementation: on the server-side I have a model binder that takes those 3 parameters - api-key, term, and rows and converts them to a C# object so that my controller action method doesn't have to parse the query string. So the controller action method signature looks something like

public IHttpActionResult Get(RequestObject request)

Problem: what I am running into with Swagger is when it generates the documentation and the test harness, it is listing the input parameters as request.api-key, request.term, and request.rows. This is because JSON it is getting from the server is prefixing object name to these values. So when you try to use Swagger UI to do an HTTP GET request, it builds the URL like

http://fake.api.com/search?request.api-key=1235&request.term=car&request.rows=10

Which is an incorrect request for the server. Now I can easily make my model binder smarter to just ignore "request." part, but that seems like a backward way of fixing this problem.

Question: how can I customize JSON generated by Swashbuckle -> Swagger on the server side so that parameter names for this particular object aren't prefixed with the object name? I did look into both ISchemaFilter and IDocumentFilter that Swashbuckle extensibility API exposes, but I am not seeing a clean way to do this. May be it is possible, but an example would help in that case.

Answer 1

Found a solution, which turned out to be the one thing I ignored - IOperationFilter. See https://github.com/domaindrivendev/Swashbuckle/issues/128 for details.

Update

Here is the code for the solution mentioned in the comment

public class IgnorePrefixParamsNameBeforeDot : IOperationFilter
{
    public void Apply(Operation operation, SchemaRegistry schemaRegistry, ApiDescription apiDescription)
    {
        if (operation.parameters != null)
        {
            foreach (Parameter param in operation.parameters.Where(p => p.name.Contains('.')))
            {
                param.name = param.name.SplitWithoutEmpty('.').Last();
            }
        }
    }
}