Modifica di Swagger-Net - Documentazione dinamica (sezione)

=== Gestione parametri Header (es. token) ===
Se le API sono protette da '''autenticazione con bearer token o basi authentication''' l'interfaccia di swagger deve dare la possibilità di effettuare l'autenticazione.<br/>
Per aggiungere un nuovo campo di input con le specifiche adeguate si rende necessario:
* Implementare l'interfaccia '''IOperationFilter''' (di Swagger.Net)
* Notificare nella configurazione la presenza di questa implementazione
<br/>
Di seguito un esempio di implementazione di Bearer Token
<syntaxhighlight lang="c#">
public class SwaggerOperationFilter : IOperationFilter {

	public void Apply(Operation operation, SchemaRegistry schemaRegistry, ApiDescription apiDescription) {
		if (operation == null)
			return;

		if (operation.parameters == null)
			operation.parameters = new List<Parameter>();

		Parameter authorizationParam = new Parameter {
			description = "Token da fornire per l'accesso al servizio",
			required = true,
			@in = "header",
			name = "Authorization",
			type = "string",
			@default = "Bearer "
		};

		operation.parameters.Add(authorizationParam);

		operation.responses.Add("400", new Response {
			description = "I dati inviati sono errati o incompleti",
			examples = new Dictionary<string, object>() {
				{ "application/json", new { Message= "...messaggio di errore..." } }
			}
		});
		operation.responses.Add("401", new Response {
			description = "Chiave di autorizzazione non valida o mancante",
			examples = new Dictionary<string, object>() {
				{ "application/json", new {Message= "Autorizzazione negata per la richiesta."} }
			}
		});
		operation.responses.Add("500", new Response {
			description = "Si è verificato un errore durante l'esecuzione della procedura",
			examples = new Dictionary<string, object>() {
				{ "application/json", new {Message= "...messaggio di errore..."} }
			}
		});
	}
}
</syntaxhighlight>
Piazzato ad esempio in un folder <code>/Filters</code>.<br/><br/>

All'interno di <code>SwaggerConfig.cs</code> segnalare l'operation filter appena implementato tramite la riga
<syntaxhighlight lang="c#">c.OperationFilter<SwaggerOperationFilter>();</syntaxhighlight>
dentro a <code>EnableSwagger("...", c=> { ... }...</code>