Added Swagger documentation (#6)

* Rename Safe to Wallet

* Added versioning to the Api

* Added Swagger documentation

Breeze/src/Breeze.Api/Controllers/NodeController.cs

@@ -2,20 +2,15 @@
 
 namespace Breeze.Api.Controllers
 {
-	[ApiVersion("1.0")]
+	
 	[Route("api/v{version:apiVersion}/[controller]")]
 	public class NodeController : Controller
-    {			 
-		[Route("connect")]
-		public IActionResult Connect(string[] args)
-		{
-			return NotFound();
-		}
-
+    {
+		[HttpGet]
 		[Route("status")]
 		public IActionResult Status()
 		{
 			return this.NotFound();
 		}
 	}
-}
+}
\ No newline at end of file

Breeze/src/Breeze.Api/Startup.cs

-using Microsoft.AspNetCore.Builder;
+using System.Linq;
+using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Mvc;
 using Microsoft.Extensions.Configuration;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Logging;
+using Swashbuckle.AspNetCore.Swagger;
 
 namespace Breeze.Api
 {
@@ -29,7 +32,30 @@ namespace Breeze.Api
 				.AddJsonOptions(options => NBitcoin.JsonConverters.Serializer.RegisterFrontConverters(options.SerializerSettings))
 				.AddControllers(services);
 
-			services.AddApiVersioning();
+			services.AddApiVersioning(options =>
+			{				
+				options.DefaultApiVersion = new ApiVersion(1, 0);
+			});
+
+			// Register the Swagger generator, defining one or more Swagger documents
+			services.AddSwaggerGen(setup =>
+			{
+				setup.SwaggerDoc("v1", new Info { Title = "Breeze.Api", Version = "v1" });
+
+				// FIXME: prepopulates the version in the URL of the Swagger UI found at http://localhost:5000/swagger
+				// temporary needed until Swashbuckle supports it out-of-the-box  
+				setup.DocInclusionPredicate((version, apiDescription) =>
+				{
+					apiDescription.RelativePath = apiDescription.RelativePath.Replace("v{version}", version);					
+					var versionParameter = apiDescription.ParameterDescriptions.SingleOrDefault(p => p.Name == "version");
+					if (versionParameter != null)
+					{
+						apiDescription.ParameterDescriptions.Remove(versionParameter);
+					}
+
+					return true;
+				});
+			});
 		}
 
 		// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
@@ -39,6 +65,15 @@ namespace Breeze.Api
 			loggerFactory.AddDebug();
 
 			app.UseMvc();
+
+			// Enable middleware to serve generated Swagger as a JSON endpoint.
+			app.UseSwagger();
+
+			// Enable middleware to serve swagger-ui (HTML, JS, CSS etc.), specifying the Swagger JSON endpoint.
+			app.UseSwaggerUI(c =>
+			{
+				c.SwaggerEndpoint("/swagger/v1/swagger.json", "Breeze.Api V1");
+			});
 		}
 	}
 }

Breeze/src/Breeze.Api/project.json

@@ -16,6 +16,7 @@
     "Microsoft.NETCore.App": "1.1.0",
     "NBitcoin": "3.0.2.10",
     "Stratis.Bitcoin": "1.0.1.2-alpha",
+    "Swashbuckle.AspNetCore": "1.0.0-rc3",
     "System.Reactive": "3.1.1",
     "System.Runtime.Loader": "4.3.0"
   },

Breeze/src/Breeze.Wallet/Controllers/WalletController.cs

@@ -6,12 +6,9 @@ using System.Security;
 using Microsoft.AspNetCore.Mvc;
 using Breeze.Wallet.Models;
 using Breeze.Wallet.Wrappers;
-using Stratis.Bitcoin;
-
 
 namespace Breeze.Wallet.Controllers
 {
-	[ApiVersion("1.0")]
 	[Route("api/v{version:apiVersion}/[controller]")]
     public class WalletController : Controller
     {
@@ -51,7 +48,8 @@ namespace Breeze.Wallet.Controllers
             }            
         }
 
-        public IActionResult Load(WalletLoadModel walletLoad)
+		[HttpGet]
+        public IActionResult Load([FromQuery]WalletLoadModel walletLoad)
         {
             // checks the request is valid
             if (!this.ModelState.IsValid)