āĻāĻāĻŋ NSwag āĻ¨āĻžāĻŽā§ āĻāĻāĻāĻŋ āĻāĻāĻ¨ā§āĻĄā§āĻ āĻ ā§āĻ¯āĻžāĻĒ āĻ¯āĻžāĻ° āĻ¸āĻ°ā§āĻŦāĻļā§āĻˇ āĻ°āĻŋāĻ˛āĻŋāĻāĻāĻŋ NSwagv13.20.0.zip āĻšāĻŋāĻ¸āĻžāĻŦā§ āĻĄāĻžāĻāĻ¨āĻ˛ā§āĻĄ āĻāĻ°āĻž āĻ¯ā§āĻ¤ā§ āĻĒāĻžāĻ°ā§āĨ¤ āĻāĻāĻŋ āĻāĻ¯āĻŧāĻžāĻ°ā§āĻāĻ¸ā§āĻā§āĻļāĻ¨ā§āĻ° āĻāĻ¨ā§āĻ¯ āĻŦāĻŋāĻ¨āĻžāĻŽā§āĻ˛ā§āĻ¯ā§āĻ° āĻšā§āĻ¸ā§āĻāĻŋāĻ āĻĒā§āĻ°āĻĻāĻžāĻ¨āĻāĻžāĻ°ā§ OnWorks-āĻ āĻ āĻ¨āĻ˛āĻžāĻāĻ¨ā§ āĻāĻžāĻ˛āĻžāĻ¨ā§ āĻ¯ā§āĻ¤ā§ āĻĒāĻžāĻ°ā§āĨ¤
NSwag āĻ¨āĻžāĻŽā§āĻ° āĻāĻ āĻ ā§āĻ¯āĻžāĻĒāĻāĻŋ āĻŦāĻŋāĻ¨āĻžāĻŽā§āĻ˛ā§āĻ¯ā§ OnWorks āĻ¸āĻš āĻ āĻ¨āĻ˛āĻžāĻāĻ¨ā§ āĻĄāĻžāĻāĻ¨āĻ˛ā§āĻĄ āĻāĻ°ā§āĻ¨ āĻāĻŦāĻ āĻāĻžāĻ˛āĻžāĻ¨āĨ¤
āĻāĻ āĻ ā§āĻ¯āĻžāĻĒāĻāĻŋ āĻāĻžāĻ˛āĻžāĻ¨ā§āĻ° āĻāĻ¨ā§āĻ¯ āĻāĻ āĻ¨āĻŋāĻ°ā§āĻĻā§āĻļāĻžāĻŦāĻ˛ā§ āĻ āĻ¨ā§āĻ¸āĻ°āĻŖ āĻāĻ°ā§āĻ¨:
- 1. āĻāĻĒāĻ¨āĻžāĻ° āĻĒāĻŋāĻ¸āĻŋāĻ¤ā§ āĻāĻ āĻ ā§āĻ¯āĻžāĻĒā§āĻ˛āĻŋāĻā§āĻļāĻ¨āĻāĻŋ āĻĄāĻžāĻāĻ¨āĻ˛ā§āĻĄ āĻāĻ°ā§āĻ¨ā§ˇ
- 2. āĻāĻŽāĻžāĻĻā§āĻ° āĻĢāĻžāĻāĻ˛ āĻŽā§āĻ¯āĻžāĻ¨ā§āĻāĻžāĻ°ā§ āĻĒā§āĻ°āĻŦā§āĻļ āĻāĻ°ā§āĻ¨ https://www.onworks.net/myfiles.php?username=XXXXX āĻāĻĒāĻ¨āĻŋ āĻ¯ā§ āĻāĻāĻāĻžāĻ°āĻ¨ā§āĻŽ āĻāĻžāĻ¨āĨ¤
- 3. āĻāĻ āĻ§āĻ°āĻ¨ā§āĻ° āĻĢāĻžāĻāĻ˛ āĻŽā§āĻ¯āĻžāĻ¨ā§āĻāĻžāĻ°ā§ āĻāĻ āĻ ā§āĻ¯āĻžāĻĒā§āĻ˛āĻŋāĻā§āĻļāĻ¨āĻāĻŋ āĻāĻĒāĻ˛ā§āĻĄ āĻāĻ°ā§āĻ¨āĨ¤
- 4. āĻāĻ āĻāĻ¯āĻŧā§āĻŦāĻ¸āĻžāĻāĻ āĻĨā§āĻā§ āĻ¯ā§āĻā§āĻ¨ā§ OS OnWorks āĻ āĻ¨āĻ˛āĻžāĻāĻ¨ āĻāĻŽā§āĻ˛ā§āĻāĻ° āĻļā§āĻ°ā§ āĻāĻ°ā§āĻ¨, āĻ¤āĻŦā§ āĻāĻ°āĻ āĻāĻžāĻ˛ā§ āĻāĻāĻ¨ā§āĻĄā§āĻ āĻ āĻ¨āĻ˛āĻžāĻāĻ¨ āĻāĻŽā§āĻ˛ā§āĻāĻ°āĨ¤
- 5. OnWorks Windows OS āĻĨā§āĻā§ āĻāĻĒāĻ¨āĻŋ āĻāĻāĻŽāĻžāĻ¤ā§āĻ° āĻļā§āĻ°ā§ āĻāĻ°ā§āĻā§āĻ¨, āĻāĻŽāĻžāĻĻā§āĻ° āĻĢāĻžāĻāĻ˛ āĻŽā§āĻ¯āĻžāĻ¨ā§āĻāĻžāĻ°ā§ āĻ¯āĻžāĻ¨ https://www.onworks.net/myfiles.php?username=XXXXX āĻāĻĒāĻ¨āĻžāĻ° āĻĒāĻāĻ¨ā§āĻĻā§āĻ° āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ°āĻāĻžāĻ°ā§āĻ° āĻ¨āĻžāĻŽ āĻ¸āĻšāĨ¤
- 6. āĻ ā§āĻ¯āĻžāĻĒā§āĻ˛āĻŋāĻā§āĻļāĻ¨āĻāĻŋ āĻĄāĻžāĻāĻ¨āĻ˛ā§āĻĄ āĻāĻ°ā§āĻ¨ āĻāĻŦāĻ āĻāĻāĻŋ āĻāĻ¨āĻ¸ā§āĻāĻ˛ āĻāĻ°ā§āĻ¨āĨ¤
- 7. āĻāĻĒāĻ¨āĻžāĻ° āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸ āĻĄāĻŋāĻ¸ā§āĻā§āĻ°āĻŋāĻŦāĻŋāĻāĻļāĻ¨ āĻ¸āĻĢā§āĻāĻāĻ¯āĻŧā§āĻ¯āĻžāĻ° āĻ¸āĻāĻā§āĻ°āĻšāĻ¸ā§āĻĨāĻ˛ āĻĨā§āĻā§ āĻāĻ¯āĻŧāĻžāĻāĻ¨ āĻĄāĻžāĻāĻ¨āĻ˛ā§āĻĄ āĻāĻ°ā§āĻ¨āĨ¤ āĻāĻāĻŦāĻžāĻ° āĻāĻ¨āĻ¸ā§āĻāĻ˛ āĻšāĻ¯āĻŧā§ āĻā§āĻ˛ā§, āĻāĻĒāĻ¨āĻŋ āĻāĻ¯āĻŧāĻžāĻāĻ¨ āĻĻāĻŋāĻ¯āĻŧā§ āĻāĻžāĻ˛āĻžāĻ¨ā§āĻ° āĻāĻ¨ā§āĻ¯ āĻ ā§āĻ¯āĻžāĻĒāĻāĻŋāĻ¤ā§ āĻĄāĻžāĻŦāĻ˛-āĻā§āĻ˛āĻŋāĻ āĻāĻ°āĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ¨āĨ¤ āĻāĻāĻžāĻĄāĻŧāĻžāĻ āĻāĻĒāĻ¨āĻŋ PlayOnLinux āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°ā§ āĻĻā§āĻāĻ¤ā§ āĻĒāĻžāĻ°ā§āĻ¨, āĻāĻ¯āĻŧāĻžāĻāĻ¨ā§āĻ° āĻāĻĒāĻ° āĻāĻāĻāĻŋ āĻ āĻāĻŋāĻ¨āĻŦ āĻāĻ¨ā§āĻāĻžāĻ°āĻĢā§āĻ¸ āĻ¯āĻž āĻāĻĒāĻ¨āĻžāĻā§ āĻāĻ¨āĻĒā§āĻ°āĻŋāĻ¯āĻŧ āĻāĻāĻ¨ā§āĻĄā§āĻ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽ āĻāĻŦāĻ āĻā§āĻŽ āĻāĻ¨āĻ¸ā§āĻāĻ˛ āĻāĻ°āĻ¤ā§ āĻ¸āĻžāĻšāĻžāĻ¯ā§āĻ¯ āĻāĻ°āĻŦā§āĨ¤
āĻāĻ¯āĻŧāĻžāĻāĻ¨ āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸ā§ āĻāĻāĻ¨ā§āĻĄā§āĻ āĻ¸āĻĢā§āĻāĻāĻ¯āĻŧā§āĻ¯āĻžāĻ° āĻāĻžāĻ˛āĻžāĻ¨ā§āĻ° āĻāĻāĻāĻŋ āĻāĻĒāĻžāĻ¯āĻŧ, āĻāĻŋāĻ¨ā§āĻ¤ā§ āĻā§āĻ¨ āĻāĻāĻ¨ā§āĻĄā§āĻ āĻĒā§āĻ°āĻ¯āĻŧā§āĻāĻ¨ āĻ¨ā§āĻāĨ¤ āĻāĻ¯āĻŧāĻžāĻāĻ¨ āĻšāĻ˛ āĻāĻāĻāĻŋ āĻāĻĒā§āĻ¨ āĻ¸ā§āĻ°ā§āĻ¸ āĻāĻāĻ¨ā§āĻĄā§āĻ āĻ¸āĻžāĻŽāĻā§āĻāĻ¸ā§āĻ¯āĻĒā§āĻ°ā§āĻŖ āĻ¸ā§āĻ¤āĻ° āĻ¯āĻž āĻ¸āĻ°āĻžāĻ¸āĻ°āĻŋ āĻ¯ā§āĻā§āĻ¨ā§ āĻ˛āĻŋāĻ¨āĻžāĻā§āĻ¸ āĻĄā§āĻ¸ā§āĻāĻāĻĒā§ āĻāĻāĻ¨ā§āĻĄā§āĻ āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽ āĻāĻžāĻ˛āĻžāĻ¤ā§ āĻĒāĻžāĻ°ā§āĨ¤ āĻŽā§āĻ˛āĻ¤, āĻāĻ¯āĻŧāĻžāĻāĻ¨ āĻ¸ā§āĻā§āĻ°ā§āĻ¯āĻžāĻ āĻĨā§āĻā§ āĻĒāĻ°ā§āĻ¯āĻžāĻĒā§āĻ¤ āĻāĻāĻ¨ā§āĻĄā§āĻ āĻĒā§āĻ¨āĻ°āĻžāĻ¯āĻŧ āĻĒā§āĻ°āĻ¯āĻŧā§āĻ āĻāĻ°āĻžāĻ° āĻā§āĻˇā§āĻāĻž āĻāĻ°āĻā§ āĻ¯āĻžāĻ¤ā§ āĻāĻāĻŋ āĻāĻ¸āĻ˛ā§ āĻāĻāĻ¨ā§āĻĄā§āĻā§āĻ° āĻĒā§āĻ°āĻ¯āĻŧā§āĻāĻ¨ āĻāĻžāĻĄāĻŧāĻžāĻ āĻ¸ā§āĻ āĻ¸āĻŽāĻ¸ā§āĻ¤ āĻāĻāĻ¨ā§āĻĄā§āĻ āĻ ā§āĻ¯āĻžāĻĒā§āĻ˛āĻŋāĻā§āĻļāĻ¨ āĻāĻžāĻ˛āĻžāĻ¤ā§ āĻĒāĻžāĻ°ā§āĨ¤
āĻ¸ā§āĻā§āĻ°ā§āĻ¨āĻļāĻāĻā§āĻ˛āĻŋ
Ad
nswag
āĻŦāĻ°ā§āĻŖāĻ¨āĻžāĻ
NSwag āĻšāĻ˛ .NET, .NET Core, Web API, āĻāĻ° āĻāĻ¨ā§āĻ¯ āĻāĻāĻāĻŋ Swagger/OpenAPI 2.0 āĻāĻŦāĻ 3.0 āĻā§āĻ˛āĻā§āĻ¨ ASP.NET āĻā§āĻ°, āĻāĻžāĻāĻĒāĻ¸ā§āĻā§āĻ°āĻŋāĻĒā§āĻ (jQuery, AngularJS, Angular 2+, Aurelia, KnockoutJS āĻāĻŦāĻ āĻāĻ°āĻ āĻ āĻ¨ā§āĻ āĻāĻŋāĻā§) āĻāĻŦāĻ āĻ āĻ¨ā§āĻ¯āĻžāĻ¨ā§āĻ¯ āĻĒā§āĻ˛ā§āĻ¯āĻžāĻāĻĢāĻ°ā§āĻŽ, C# āĻ āĻ˛ā§āĻāĻžāĨ¤ OpenAPI/Swagger āĻ¸ā§āĻĒā§āĻ¸āĻŋāĻĢāĻŋāĻā§āĻļāĻ¨ āĻāĻāĻāĻŋ RESTful āĻāĻ¯āĻŧā§āĻŦ API āĻŦāĻ°ā§āĻŖāĻ¨āĻž āĻāĻ°āĻ¤ā§ JSON āĻāĻŦāĻ JSON āĻ¸ā§āĻāĻŋāĻŽāĻž āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°ā§āĨ¤ NSwag āĻĒā§āĻ°āĻāĻ˛ā§āĻĒāĻāĻŋ āĻŦāĻŋāĻĻā§āĻ¯āĻŽāĻžāĻ¨ āĻĨā§āĻā§ OpenAPI āĻ¸ā§āĻĒā§āĻ¸āĻŋāĻĢāĻŋāĻā§āĻļāĻ¨ āĻ¤ā§āĻ°āĻŋ āĻāĻ°āĻžāĻ° āĻāĻ¨ā§āĻ¯ āĻā§āĻ˛ āĻ¸āĻ°āĻŦāĻ°āĻžāĻš āĻāĻ°ā§ ASP.NET āĻāĻ OpenAPI āĻ¸ā§āĻĒā§āĻ¸āĻŋāĻĢāĻŋāĻā§āĻļāĻ¨ āĻĨā§āĻā§ āĻāĻ¯āĻŧā§āĻŦ API āĻāĻ¨ā§āĻā§āĻ°ā§āĻ˛āĻžāĻ° āĻāĻŦāĻ āĻā§āĻ˛āĻžāĻ¯āĻŧā§āĻ¨ā§āĻ āĻā§āĻĄāĨ¤ āĻĒā§āĻ°āĻāĻ˛ā§āĻĒāĻāĻŋ āĻāĻāĻāĻŋ āĻā§āĻ˛āĻā§āĻāĻ¨ā§ Swashbuckle (OpenAPI/Swagger āĻā§āĻ¨āĻžāĻ°ā§āĻļāĻ¨) āĻāĻŦāĻ AutoRest (āĻā§āĻ˛āĻžāĻ¯āĻŧā§āĻ¨ā§āĻ āĻā§āĻ¨āĻžāĻ°ā§āĻļāĻ¨) āĻāĻ° āĻāĻžāĻ°ā§āĻ¯āĻāĻžāĻ°āĻŋāĻ¤āĻž āĻāĻāĻ¤ā§āĻ°āĻŋāĻ¤ āĻāĻ°ā§ (āĻāĻ āĻĻā§āĻāĻŋ libs āĻĒā§āĻ°āĻ¯āĻŧā§āĻāĻ¨ āĻ¨ā§āĻ)āĨ¤ āĻāĻāĻāĻžāĻŦā§ āĻ āĻ¨ā§āĻ āĻ āĻ¸āĻā§āĻāĻ¤āĻŋ āĻāĻĄāĻŧāĻžāĻ¨ā§ āĻ¯āĻžāĻ¯āĻŧ āĻāĻŦāĻ āĻ¯ā§ āĻŦā§āĻļāĻŋāĻˇā§āĻā§āĻ¯āĻā§āĻ˛āĻŋ OpenAPI āĻ¸ā§āĻĒā§āĻ¸āĻŋāĻĢāĻŋāĻā§āĻļāĻ¨ āĻŦāĻž JSON āĻ¸ā§āĻāĻŋāĻŽāĻž āĻĻā§āĻŦāĻžāĻ°āĻž āĻāĻžāĻ˛āĻāĻžāĻŦā§ āĻŦāĻ°ā§āĻŖāĻ¨āĻž āĻāĻ°āĻž āĻšāĻ¯āĻŧ āĻ¨āĻž āĻ¸ā§āĻā§āĻ˛āĻŋ āĻāĻ°āĻ āĻāĻžāĻ˛ āĻ¸āĻŽāĻ°ā§āĻĨāĻŋāĻ¤ (āĻ¯ā§āĻŽāĻ¨ āĻāĻ¤ā§āĻ¤āĻ°āĻžāĻ§āĻŋāĻāĻžāĻ°, enum āĻāĻŦāĻ āĻ°ā§āĻĢāĻžāĻ°ā§āĻ¨ā§āĻ¸ āĻšā§āĻ¯āĻžāĻ¨ā§āĻĄāĻ˛āĻŋāĻ)āĨ¤ NSwag āĻĒā§āĻ°āĻā§āĻā§āĻ JSON āĻ¸ā§āĻāĻŋāĻŽāĻž āĻšā§āĻ¯āĻžāĻ¨ā§āĻĄāĻ˛āĻŋāĻ āĻāĻŦāĻ C#/TypeScript āĻā§āĻ˛āĻžāĻ¸/āĻāĻ¨ā§āĻāĻžāĻ°āĻĢā§āĻ¸ āĻā§āĻ¨āĻžāĻ°ā§āĻļāĻ¨ā§āĻ° āĻāĻ¨ā§āĻ¯ .NET-āĻāĻ° āĻāĻ¨ā§āĻ¯ NJsonSchema āĻŦā§āĻ¯āĻžāĻĒāĻāĻāĻžāĻŦā§ āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°ā§āĨ¤
āĻŦā§āĻļāĻŋāĻˇā§āĻā§āĻ¯
- C# āĻĨā§āĻā§ Swagger 2.0 āĻāĻŦāĻ OpenAPI 3.0 āĻ¸ā§āĻĒā§āĻ¸āĻŋāĻĢāĻŋāĻā§āĻļāĻ¨ āĻ¤ā§āĻ°āĻŋ āĻāĻ°ā§āĻ¨ ASP.NET (āĻā§āĻ°) āĻāĻ¨ā§āĻā§āĻ°ā§āĻ˛āĻžāĻ°
- āĻŽāĻžāĻ§ā§āĻ¯āĻŽā§ āĻāĻļāĻŽāĻž āĻĒāĻ°āĻŋāĻŦā§āĻļāĻ¨ ASP.NET (āĻā§āĻ°) āĻŽāĻŋāĻĄāĻ˛āĻāĻ¯āĻŧā§āĻ¯āĻžāĻ°, āĻāĻā§āĻāĻŋāĻāĻāĻžāĻŦā§ Swagger UI āĻŦāĻž ReDoc āĻ¸āĻš
- āĻāĻ āĻāĻļāĻŽāĻž āĻĨā§āĻā§ C# āĻŦāĻž TypeScript āĻā§āĻ˛āĻžāĻ¯āĻŧā§āĻ¨ā§āĻ/āĻĒā§āĻ°āĻā§āĻ¸āĻŋ āĻ¤ā§āĻ°āĻŋ āĻāĻ°ā§āĻ¨
- āĻ¸āĻŦāĻāĻŋāĻā§ CLI āĻāĻ° āĻŽāĻžāĻ§ā§āĻ¯āĻŽā§ āĻ¸ā§āĻŦāĻ¯āĻŧāĻāĻā§āĻ°āĻŋāĻ¯āĻŧ āĻšāĻ¤ā§ āĻĒāĻžāĻ°ā§ (NuGet āĻā§āĻ˛ āĻŦāĻž āĻŦāĻŋāĻ˛ā§āĻĄ āĻāĻžāĻ°ā§āĻā§āĻā§āĻ° āĻŽāĻžāĻ§ā§āĻ¯āĻŽā§ āĻŦāĻŋāĻ¤āĻ°āĻŖ āĻāĻ°āĻž āĻšāĻ¯āĻŧ; āĻŦāĻž NPM)
- CLI JSON āĻĢāĻžāĻāĻ˛ āĻŦāĻž NSwagStudio Windows UI āĻāĻ° āĻŽāĻžāĻ§ā§āĻ¯āĻŽā§ āĻāĻ¨āĻĢāĻŋāĻāĻžāĻ° āĻāĻ°āĻž āĻšāĻ¯āĻŧā§āĻā§
- Windows GUI, NSwagStudio āĻŦā§āĻ¯āĻŦāĻšāĻžāĻ° āĻāĻ°āĻž āĻ¸āĻšāĻ
āĻĒā§āĻ°ā§āĻā§āĻ°āĻžāĻŽāĻŋāĻ āĻāĻžāĻˇāĻž
C#
āĻŦāĻŋāĻāĻžāĻ
āĻāĻāĻŋ āĻāĻŽāĻ¨ āĻāĻāĻāĻŋ āĻ ā§āĻ¯āĻžāĻĒā§āĻ˛āĻŋāĻā§āĻļāĻ¨ āĻ¯āĻž https://sourceforge.net/projects/nswag.mirror/ āĻĨā§āĻā§āĻ āĻāĻ¨āĻž āĻ¯ā§āĻ¤ā§ āĻĒāĻžāĻ°ā§āĨ¤ āĻāĻŽāĻžāĻĻā§āĻ° āĻŦāĻŋāĻ¨āĻžāĻŽā§āĻ˛ā§āĻ¯ā§āĻ° āĻ āĻĒāĻžāĻ°ā§āĻāĻŋāĻ āĻ¸āĻŋāĻ¸ā§āĻā§āĻŽāĻā§āĻ˛āĻŋāĻ° āĻŽāĻ§ā§āĻ¯ā§ āĻāĻāĻāĻŋ āĻĨā§āĻā§ āĻ¸āĻŦāĻā§āĻ¯āĻŧā§ āĻ¸āĻšāĻ āĻāĻĒāĻžāĻ¯āĻŧā§ āĻ āĻ¨āĻ˛āĻžāĻāĻ¨ā§ āĻāĻžāĻ˛āĻžāĻ¨ā§āĻ° āĻāĻ¨ā§āĻ¯ āĻāĻāĻŋ OnWorks-āĻ āĻšā§āĻ¸ā§āĻ āĻāĻ°āĻž āĻšāĻ¯āĻŧā§āĻā§āĨ¤