Update API documentation

Author: LEDfan

src/main/java/eu/openanalytics/containerproxy/api/ProxyStatusController.java

@@ -80,10 +80,10 @@ public class ProxyStatusController {
                             mediaType = "application/json",
                             schema = @Schema(implementation = ChangeProxyStatusDto.class),
                             examples = {
-                                    @ExampleObject(name = "Stopping", description = "Stop a proxy.", value = "{\"desiredStatus\": \"Stopping\"}"),
-                                    @ExampleObject(name = "Pausing", description = "Pause a proxy.", value = "{\"desiredStatus\": \"Pausing\"}"),
-                                    @ExampleObject(name = "Resuming", description = "Resume a proxy.", value = "{\"desiredStatus\": \"Resuming\"}"),
-                                    @ExampleObject(name = "Resuming with parameters", description = "Resume a proxy.", value = "{\"desiredStatus\": \"Resuming\", \"parameters\":{\"resources\":\"2 CPU cores - 8G RAM\",\"other_parameter\":\"example\"}}")
+                                    @ExampleObject(name = "Stopping", description = "Stop a proxy.", value = "{\"desiredState\": \"Stopping\"}"),
+                                    @ExampleObject(name = "Pausing", description = "Pause a proxy.", value = "{\"desiredState\": \"Pausing\"}"),
+                                    @ExampleObject(name = "Resuming", description = "Resume a proxy.", value = "{\"desiredState\": \"Resuming\"}"),
+                                    @ExampleObject(name = "Resuming with parameters", description = "Resume a proxy.", value = "{\"desiredState\": \"Resuming\", \"parameters\":{\"resources\":\"2 CPU cores - 8G RAM\",\"other_parameter\":\"example\"}}")
                             }
                     )
             )
@@ -148,7 +148,7 @@ public ResponseEntity<ApiResponse<Void>> changeProxyStatus(@PathVariable String
             }
             asyncProxyService.stopProxy(proxy, false);
         } else {
-            return ApiResponse.fail("Invalid desiredStatus");
+            return ApiResponse.fail("Invalid desiredState");
         }
 
         return ApiResponse.success();

src/main/java/eu/openanalytics/containerproxy/util/ProxyMappingManager.java

@@ -190,6 +190,7 @@ public void onApplicationEvent(ContextClosedEvent event) {
 	}
 
 	private final DefaultResponseListener defaultResponseListener = responseExchange -> {
+		// note: if ShinyProxy was restarted it can take up to one minute for the request to timeout/fail
 		if (!responseExchange.isResponseChannelAvailable()) {
 			return false;
 		}