Added batch baking to Readme. Tweaks to swagger

Author: GCHQDeveloper1138

README.md

@@ -170,6 +170,92 @@ Response:
 }
 ```
 
+### `/batch/bake`
+
+`/batch/bake` allows a user to POST multiple input values and a configuration for a CyberChef Recipe. The application will run each elemnt of the input through the recipe and return the results as an array of output objects.
+
+This endpoint accepts a POST request with the following body:
+
+|Parameter|Type|Description|
+|---|---|---|
+input|Array|The input data for the recipe. Currently accepts an array of Strings.
+recipe|String or Object or Array|One or more operations, with optional arguments. Uses default arguments if they're not defined here.
+outputType (optional)|String|The [Data Type](https://github.com/gchq/CyberChef/wiki/Adding-a-new-operation#data-types) that you would like the result of the bakes to be returned as. This will not work with `File` or `List<File>` at the moment.
+
+#### Example: one operation, default arguments
+```javascript
+{
+    "input": ["One", "two", "three", "four"],
+    "recipe": "to decimal"
+}
+```
+
+Response:
+```javascript
+[
+  {
+    "success": true,
+    "value": "79 110 101",
+    "type": "string"
+  },
+  {
+    "success": true,
+    "value": "116 119 111",
+    "type": "string"
+  },
+  {
+    "success": true,
+    "value": "116 104 114 101 101",
+    "type": "string"
+  },
+  {
+    "success": true,
+    "value": "102 111 117 114",
+    "type": "string"
+  }
+]
+
+```
+> For more information on how operation names are handled, see the [Node API docs](https://github.com/gchq/CyberChef/wiki/Node-API#operation-names)
+
+#### Example: one operation, non-default arguments by name
+```javascript
+{
+    "input": ["One", "two", "three", "four"],
+    "recipe": {
+        "op": "to decimal",
+        "args": {
+            "delimiter": "Colon"
+        }
+    }
+}
+```
+Response:
+```javascript
+[
+  {
+    "success": true,
+    "value": "79:110:101",
+    "type": "string"
+  },
+  {
+    "success": true,
+    "value": "116:119:111",
+    "type": "string"
+  },
+  {
+    "success": true,
+    "value": "116:104:114:101:101",
+    "type": "string"
+  },
+  {
+    "success": true,
+    "value": "102:111:117:114",
+    "type": "string"
+  }
+]
+```
+
 ### `/magic`
 
 [Find more information about what the Magic operation does here](https://github.com/gchq/CyberChef/wiki/Automatic-detection-of-encoded-data-using-CyberChef-Magic)

swagger.yml

@@ -126,8 +126,8 @@ paths:
     post:
       summary: Bakes a batch of data with a recipe
       description: >
-        Bake a recipe defined in JSON over and array of input data. For an example JSON recipe, build a recipe on 
-        [CyberChef](https://gchq.github.io/CyberChef/) and click save. Select "clean JSON".
+        Bake a recipe defined in JSON over an array of input data. To obtain a JSON-formatted recipe, build a recipe on 
+        [CyberChef](https://gchq.github.io/CyberChef/) and click save. Select "clean JSON" and copy the output.
         
         Input data must be in the form of an array. All items will be baked individually 
         and an individual result object provided for each in the response
@@ -163,10 +163,10 @@ paths:
                 - type: "string"
                   value: "01001110"
                   success: true
-                - error: "Bad Recipe"
+                - error: "Spline reticulation exception"
                   success: false
         '400':
-          description: Bad request
+          description: Bad request, most often a syntactically invalid recipe
 
 components:
   schemas: