"Tags" feature endpoint changes

Author: AlbertMN

source/includes/_files.md

@@ -29,10 +29,47 @@ curl https://api.simplyprint.io/{id}/files/GetFiles?f=123&search=benchy \
         "printsFailed": 0,
         "timesSliced": 0
       },
-      "user_id": 6044,
+      "user_id": 123,
       "thumbnail": 1,
       "folder": 0,
-      "user": 6044
+      "user": 123,
+    },
+    {
+      "id": "e82ab9e1cc3c20850d94d5cf539390c0",
+      "name": "3DBenchy",
+      "ext": "gcode",
+      "type": "model",
+      "size": 1285384,
+      "created": "December 23, 2022, 18:00",
+      "createdint": 1671813330,
+      "printData": {
+        "printsDone": 10,
+        "printsCancelled": 5,
+        "printsFailed": 0,
+        "timesSliced": 0
+      },
+      "user_id": 123,
+      "thumbnail": 1,
+      "folder": 0,
+      "user": 123,
+      "forPrinters": [
+        // list of printers IDs selected for file; key not present if no printers are selected 
+        1,
+        2,
+        3
+      ],
+      "tags": {
+        "nozzle": 0.6,
+        "material": [
+          {
+            "ext": 0,
+            "type": 123,
+            "color": "Green",
+            "hex":"#4CAF50"
+          }
+        ],
+        "custom": [1, 2, 3]
+      }
     }
   ],
   "folders": [

source/includes/_printers.md

@@ -134,6 +134,18 @@ curl https://api.simplyprint.io/{id}/printers/Get \
         "time": 12627,
         "canPreview": true,
         "layer": null
+      },
+      "tags": {
+        "nozzle": 0.6,
+        "material": [
+          {
+            "ext": 0,
+            "type": 123,
+            "color": "Green",
+            "hex":"#4CAF50"
+          }
+        ],
+        "custom": [1, 2, 3]
       }
     },
     ...

source/includes/_queue.md

@@ -158,6 +158,7 @@ This endpoint gets the next item in the queue for the specified printer. The nex
 | `settings.fit` | boolean | no | Print must fit printer's bed.<br>**Default: true** |
 | `settings.gcodeAnalysis` | boolean | no | Must have gcode analysis.<br>**Default: true** |
 | `settings.printerTemps` | boolean | no | File must have a max temperature that is lower than the printer's max temperature.<br>**Default: true** |
+| `settings.tags` | boolean | no | Printer must match possible queue item tags (nozzle size, material data & custom tags).<br>**Default: true** |
 
 ### Response
 
@@ -249,7 +250,19 @@ curl https://api.simplyprint.io/{id}/queue/GetItems?p=1234 \
           "v": 5
         },
         "user": "John Doe",
-        "user_id": 1234
+        "user_id": 1234,
+        "tags": {
+          "nozzle": 0.6,
+          "material": [
+            {
+              "ext": 0,
+              "type": 123,
+              "color": "Green",
+              "hex":"#4CAF50"
+            }
+          ],
+          "custom": [1, 2, 3]
+        }
       }
     ]
   }