api docs update

APIFolder/api.htm

@@ -20,6 +20,7 @@
                         <li><a href="#top">Mifos X API Documentation</a></li>
                         <li><a href="#interact">Try The API From Your Browser</a></li>
                         <li><a href="#genopts">Generic Options</a></li>
+                        <li><a href="#dates_and_numbers">Updating Dates and Numbers</a></li>
                         <li><a href="#authentication_overview">Authentication Overview</a></li>
                         <li><a href="#errors">Errors</a></li>
                         <li><a href="#fullapi_matrix">Full API Matrix</a></li>
@@ -190,6 +191,18 @@
             </div>
     
         </div>
+        
+        <a id="dates_and_numbers" name="dates_and_numbers" class="old-syle-anchor">&nbsp;</a>
+        <div class="method-section">
+            <div class="method-description">
+                <h3>Updating Dates and Numbers</h3>
+                <h4>Dates</h4>
+                <p>Put in thing about suppying date_format and 'Formatted' being added onto end of field</p>
+                <h4>Numbers</h4>
+                <p>Put in whatever happens to numbers here.</p>
+           </div>
+    
+        </div>
     
         <a id="authentication_overview" name="authentication_overview" class="old-syle-anchor">&nbsp;</a>
         <div class="method-section">
@@ -2011,16 +2024,11 @@ Request Body:
 Content-Type: application/json
 Request Body:
 {
-  "name": "Demo branch 9 changed",
-  "externalId": "11",
-  "dateFormat": "dd MMMM yyyy",
-  "openingDateFormatted": "05 September 2011",
-  "parentId": 1
+  "name": "Name is updated"
 }
 </code>
-<code class="method-response">
-{
-  "entityId": 9
+<code class="method-response">{
+  "entityId": 1
 }
 </code>
             </div>
@@ -2933,17 +2941,26 @@ Request Body:
 	<div class="method-section">
 	    <div class="method-description">
 	        <h4>Verify authentication</h4>
-	        <p>Verifies that the credentials provided successfully authenticate and returns the set of permissions allowed by that user.</p>
-	        <p>Example Request: 
-	        <a style="word-wrap: break-word;" href="https://localhost:8443/mifosng-provider/api/v1/authentication?username=super1&password=demo">https://localhost:8443/mifosng-provider/api/v1/authentication?username=super1&password=demo</a>
-	        </p>
+	        <p>Authenticates the credentials provided and returns the set of permissions allowed.</p>
 	    </div>
 	    <div class="method-example">
-	        <code class="method-declaration">POST https://thedomainname/api/v1/authentication?username=super1&password=demo</code>
+	        <code class="method-declaration">POST https://thedomainname/api/v1/authentication?username={userName}&password={password}</code>
 <code class="method-request">POST https://localhost:8443/mifosng-provider/api/v1/authentication?username=super1&password=demo
-Content-Type: application/xml
+Content-Type: application/json
+No Request Body
 </code>
-<code class="method-response">
+<code class="method-response">{
+    "username": "super1",
+    "userId": 2,
+    "base64EncodedAuthenticationKey": "c3VwZXIxOmRlbW8=",
+    "authenticated": true,
+    "permissions": [
+    "USER_ADMINISTRATION_SUPER_USER_ROLE",
+    "REPORTING_SUPER_USER_ROLE",
+    "PORTFOLIO_MANAGEMENT_SUPER_USER_ROLE",
+    "ORGANISATION_ADMINISTRATION_SUPER_USER_ROLE"
+    ]
+}
 </code>
 	    </div>
 	</div>    

APIFolder/docUpdateComments.txt

@@ -3,17 +3,16 @@ template for waiver/repayment... is it same for both? no type needed? (might hav
 
 new loan template ... is it 2 templates... one to pick product... and 2nd to return default properties in selected product or is it meant that if only one product then use that. 
 
+
+
 Configuration
-If you put a new currency config in and it deletes a currently in using { "selectedItems": ["USD", "GBP","XOF","ETB"] } then an exception report is returned
-Works fine using currencies (updated docs)....
-and should it return just an ok and empty set rather than empty notSelectedCurrencies and currencies
-should update only select currencies and not allow notSelectedCurrencies?
+All Good!
 
-
-Offices
+Offices (creates and updates not working with last commit)
 When creating new offices.. do i have to supply  "dateFormat": & "openingDateFormatted" for openingDate?  What is list of dateFormats?
 openingDate seems mandatory... but when the 'pair' not supplied I get NullPointerException
 could just openingDate be used?
 Note that openingData is passed as openingDateFormatted and a dateFormat is provided to convert the date from the way your UI records it to a common format.
+hierarchy update results in exception (prob  solved by using unrecognized parameter exception)