Adding custom operations

I’m trying to add Owin OAuth authorization server’s token endpoint to the swagger api docs, but Swashbuckle can only read operations from the IApiExplorer. Owin uses a custom middleware to create the OAuth token endpoint with app.UseOAuthAuthorizationServer(options) call, so it won’t appear on the IApiExplorer.

I need something like this:

swaggerConfig.operations.Add(new Operation() {
    operationId = "auth/token",
    consumes = new List<string>
    {
        "application/x-www-form-urlencoded"
    },
    parameters = new List<Parameter> {
        new Parameter
        {
            type = "string",
            name = "grant_type",
            required = true,
            @in = "formData"
        },
        new Parameter
        {
            type = "string",
            name = "username",
            required = false,
            @in = "formData"
        },
        new Parameter
        {
            type = "string",
            name = "password",
            required = false,
            @in = "formData"
        }
    }
});

How could I manually add custom operations to the docs?

[henkosch]

Thank you!

I was able to add the custom operation like this:

class AuthTokenOperation : IDocumentFilter
{
    public void Apply(SwaggerDocument swaggerDoc, SchemaRegistry schemaRegistry, IApiExplorer apiExplorer)
    {
        swaggerDoc.paths.Add("/auth/token", new PathItem
        {
            post = new Operation
            {
                tags = new List<string> { "Auth" },
                consumes = new List<string>
                {
                    "application/x-www-form-urlencoded"
                },
                parameters = new List<Parameter> {
                    new Parameter
                    {
                        type = "string",
                        name = "grant_type",
                        required = true,
                        @in = "formData"
                    },
                    new Parameter
                    {
                        type = "string",
                        name = "username",
                        required = false,
                        @in = "formData"
                    },
                    new Parameter
                    {
                        type = "string",
                        name = "password",
                        required = false,
                        @in = "formData"
                    }
                }
            }
        });
    }
}

httpConfig.EnableSwagger(c =>
{
    c.DocumentFilter<AuthTokenOperation>();
});

[TermanEmil]

Hey Is it possible to make a custom operation with raw URL input? I need it to document some OData endpoints.

For example: /odata/People?$select=Id,Name&$expand=Passport($select=IDNP)