Corrected route template defaults and comments for API versioning by namespace sample

Author: Chris Martinez

samples/webapi/ByNamespaceWebApiSample/Startup.cs

@@ -21,13 +21,13 @@ public void Configuration( IAppBuilder builder )
             configuration.Routes.MapHttpRoute(
                 "VersionedQueryString",
                 "api/{controller}/{accountId}",
-                new { accountId = Optional } );
+                defaults: null );
 
             configuration.Routes.MapHttpRoute(
                 "VersionedUrl",
                 "v{apiVersion}/{controller}/{accountId}",
-                new { accountId = Optional },
-                new { apiVersion = new ApiVersionRouteConstraint() } );
+                defaults: null,
+                constraints: new { apiVersion = new ApiVersionRouteConstraint() } );
 
             builder.UseWebApi( httpServer );
         }

samples/webapi/ByNamespaceWebApiSample/V1/Controllers/AgreementsController.cs

@@ -8,8 +8,8 @@
     [ApiVersion( "1.0" )]
     public class AgreementsController : ApiController
     {
-        // GET ~/v1/agreements
-        // GET ~/agreements?api-version=1.0
+        // GET ~/v1/agreements/{accountId}
+        // GET ~/agreements/{accountId}?api-version=1.0
         public IHttpActionResult Get( string accountId ) => Ok( new Agreement( GetType().FullName, accountId, Request.GetRequestedApiVersion().ToString() ) );
     }
 }

samples/webapi/ByNamespaceWebApiSample/V2/Controllers/AgreementsController.cs

@@ -8,8 +8,8 @@
     [ApiVersion( "2.0" )]
     public class AgreementsController : ApiController
     {
-        // GET ~/v2/agreements
-        // GET ~/agreements?api-version=2.0
+        // GET ~/v2/agreements/{accountId}
+        // GET ~/agreements/{accountId}?api-version=2.0
         public IHttpActionResult Get( string accountId ) => Ok( new Agreement( GetType().FullName, accountId, Request.GetRequestedApiVersion().ToString() ) );
     }
 }

samples/webapi/ByNamespaceWebApiSample/V3/Controllers/AgreementsController.cs

@@ -8,8 +8,8 @@
     [ApiVersion( "3.0" )]
     public class AgreementsController : ApiController
     {
-        // GET ~/v3/agreements
-        // GET ~/agreements?api-version=3.0
+        // GET ~/v3/agreements/{accountId}
+        // GET ~/agreements/{accountId}?api-version=3.0
         public IHttpActionResult Get( string accountId ) => Ok( new Agreement( GetType().FullName, accountId, Request.GetRequestedApiVersion().ToString() ) );
     }
 }