[add] examples

Author: fpgasar

src/TesterApp/Controllers/Api/v1/Groups/GetMultipleController.cs

@@ -15,17 +15,21 @@ public class GetMultipleController : Simplify.Web.Controller
 {
 	public override ControllerResponse Invoke()
 	{
-		var items = new List<GroupViewModel>
+		var languageCode = Thread.CurrentThread.CurrentCulture.TwoLetterISOLanguageName;
+
+		var items = new List<GroupViewModel>();
+
+		switch (languageCode)
 		{
-			new GroupViewModel
-			{
-				Name = "Group 1"
-			},
-			new GroupViewModel
-			{
-				Name = "Group 2"
-			}
-		};
+			case "ru":
+				items.Add(new() {Name = "Группа 1"});
+				items.Add(new() {Name = "Группа 2"});
+				break;
+			default:
+				items.Add(new() {Name = "Group 1"});
+				items.Add(new() {Name = "Group 2"});
+				break;
+		}
 
 		// Items retrieve
 

src/TesterApp/Controllers/Api/v1/Users/CreateController.cs

@@ -1,13 +1,15 @@
 using Microsoft.AspNetCore.Mvc;
 using Simplify.Web;
 using Simplify.Web.Attributes;
+using Simplify.Web.Swagger;
 using TesterApp.ViewModels;
 
 namespace TesterApp.Controllers.Api.v1.Users;
 
 [Post("/api/v1/users")]
 [ApiVersion("1.0")]
 [Produces("application/text")]
+[ProducesRequestBody(typeof(UserAddViewModel))]
 public class CreateController : AsyncController<UserAddViewModel>
 {
 	public override async Task<ControllerResponse> Invoke()

src/TesterApp/Program.cs

@@ -1,3 +1,5 @@
+using Microsoft.OpenApi.Any;
+using Microsoft.OpenApi.Models;
 using Simplify.DI;
 using Simplify.Web;
 using Simplify.Web.Json.Model.Binding;
@@ -14,7 +16,57 @@
 	.Verify();
 
 builder.Services.AddEndpointsApiExplorer()
-	.AddSwaggerGen(x => x.AddSimplifyWebSwagger());
+	.AddSwaggerGen(x => {
+		x.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme
+		{
+			Name = "Authorization",
+			In = ParameterLocation.Header,
+			Type = SecuritySchemeType.ApiKey,
+			Scheme = "Bearer",
+			BearerFormat = "JWT",
+			Description = "Input your Bearer token in this format - Bearer {your token here} to access this API",
+		});
+		x.AddSecurityRequirement(new OpenApiSecurityRequirement
+		{
+			{
+				new OpenApiSecurityScheme
+				{
+					Reference = new OpenApiReference
+					{
+						Type = ReferenceType.SecurityScheme,
+						Id = "Bearer",
+					},
+					Scheme = "Bearer",
+					Name = "Bearer",
+					In = ParameterLocation.Header,
+				},
+				new List<string>()
+			}
+		});
+
+		var args = new SimplifyWebSwaggerArgs();
+		var parameter = new OpenApiParameter{
+			Name = "Accept-Language",
+			In = ParameterLocation.Header,
+			Description = "Language preference for the response.",
+			Required = true,
+			AllowEmptyValue = true,
+			Example = new OpenApiString("en-US"),
+			Schema = new OpenApiSchema
+			{
+				Default = new OpenApiString("en-US"),
+				Enum = new List<IOpenApiAny>
+				{
+					new OpenApiString("en-US"),
+					new OpenApiString("ru-RU"),
+				}
+			}
+		};
+		
+		args.Parameters.Add(parameter);
+
+		x.AddSimplifyWebSwagger(args);
+	});
 
 // Configuration
 

src/TesterApp/appsettings.json

@@ -0,0 +1,5 @@
+{
+  "SimplifyWebSettings": {
+	"AcceptBrowserLanguage": true
+  }
+}