ADD: made view optional in setdir

Author: PascalCorpsman

src/rest.md

@@ -4,17 +4,19 @@ This is the CopyCommander2 Rest API Documentation.
 
 CopyCommander REST API only supports JSON as data format. To see how to enable / setup the REST functionality visit the [rest api](how_to_use.md#rest-api) section in the how_to_use document.
 
-There are 2 kinds of paths supported by CopyCommander2
+There are 2 kinds of paths supported by CopyCommander2.
 
 #### Normal paths:
 Normal paths are always available and can be used to get status, start jobs, ...
 
 #### Zombie paths:
 Zombie paths are used to control the application (visible to the user), to enable these paths you need to pass in a extra command line paramter.
 
+## List of available methods / paths
 | Method | Overview | Kind | Description
 | --- | --- | --- | --- |
 | GET | [/API/status](#get-apistatus) | normal | get current state of application
+| GET | [/API/view/list](#get-apiviewlist) | normal | get list of content from a spezific view
 | POST | [/API/zombie/setdir](#post-apizombiesetdir) | zombie | set directory path for left or right view
 
 ## GET /API/status
@@ -27,6 +29,10 @@ Returns the current status of the application.
 **Path:** `/API/status`  
 **Content-Type:** Not applicable
 
+### Query Parameters
+
+none
+
 ### Response
 
 **Content-Type:** `application/json`
@@ -40,6 +46,12 @@ Returns the current status of the application.
 | `LeftDir` | string | Path to the left directory |
 | `RightDir` | string | Path to the right directory |
 
+### Example Request
+
+```
+GET /API/status
+```
+
 ### Example Response
 
 ```json
@@ -111,11 +123,11 @@ Sets the directory path for either the left or right view.
 **Path:** `/API/zombie/setdir`  
 **Content-Type:** `application/json`
 
-### Request Schema
+### Post Request Schema
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
-| `view` | string | Yes | Must be either "left" or "right" |
+| `view` | string | No | Must be either "left" or "right", default (left) |
 | `dir` | string | Yes | Directory path to set |
 
 ### Example Request
@@ -127,8 +139,8 @@ Sets the directory path for either the left or right view.
 }
 ```
 
-### Response
+### Example Response
 
 **Status Codes:**
 - `204 No Content` - Directory successfully set
-- `422 Unprocessable Entity` - Invalid request data / target dir, does not exist.
+- `422 Unprocessable Entity` - Invalid request data / target dir, does not exist.

src/urestapi.pas

@@ -146,17 +146,20 @@
   Const aContent: TJSONObj): Boolean;
 Var
   jv, jd: TJSONValue;
-  dir: String;
+  view, dir: String;
 Begin
   result := false;
   Try
+    view := 'left';
     jv := aContent.FindPath('view') As TJSONValue;
-    If Not assigned(jv) Then exit;
+    If assigned(jv) Then Begin
+      view := trim(jv.Value);
+    End;
     jd := aContent.FindPath('dir') As TJSONValue;
     If Not assigned(jd) Then exit;
     dir := jd.Value;
     If Not DirectoryExists(dir) Then exit;
-    Case lowercase(trim(jv.Value)) Of
+    Case lowercase(view) Of
       'left': form1.LoadDir(dir, form1.fLeftView);
       'right': form1.LoadDir(dir, form1.fRightView);
     Else Begin