Set more accurate swagger docs in terms of what props are required/nullable for device long URLs

docs/swagger/definitions/DeviceLongUrls.json

@@ -4,17 +4,17 @@
         "android": {
             "description": "The long URL to redirect to when the short URL is visited from a device running Android",
             "type": "string",
-            "nullable": true
+            "nullable": false
         },
         "ios": {
             "description": "The long URL to redirect to when the short URL is visited from a device running iOS",
             "type": "string",
-            "nullable": true
+            "nullable": false
         },
         "desktop": {
             "description": "The long URL to redirect to when the short URL is visited from a desktop browser",
             "type": "string",
-            "nullable": true
+            "nullable": false
         }
     }
 }

docs/swagger/definitions/DeviceLongUrlsEdit.json

@@ -0,0 +1,17 @@
+{
+    "type": "object",
+    "allOf": [{
+        "$ref": "./DeviceLongUrls.json"
+    }],
+    "properties": {
+        "android": {
+            "nullable": true
+        },
+        "ios": {
+            "nullable": true
+        },
+        "desktop": {
+            "nullable": true
+        }
+    }
+}

docs/swagger/definitions/DeviceLongUrlsResp.json

@@ -2,6 +2,6 @@
     "type": "object",
     "required": ["android", "ios", "desktop"],
     "allOf": [{
-        "$ref": "./DeviceLongUrls.json"
+        "$ref": "./DeviceLongUrlsEdit.json"
     }]
 }

docs/swagger/definitions/ShortUrlEdition.json

@@ -6,7 +6,7 @@
             "type": "string"
         },
         "deviceLongUrls": {
-            "$ref": "./DeviceLongUrls.json"
+            "$ref": "./DeviceLongUrlsEdit.json"
         },
         "validSince": {
             "description": "The date (in ISO-8601 format) from which this short code will be valid",

docs/swagger/paths/v1_short-urls.json

@@ -296,6 +296,9 @@
                                 "type": "object",
                                 "required": ["longUrl"],
                                 "properties": {
+                                    "deviceLongUrls": {
+                                        "$ref": "../definitions/DeviceLongUrls.json"
+                                    },
                                     "customSlug": {
                                         "description": "A unique custom slug to be used instead of the generated short code",
                                         "type": "string"

docs/swagger/paths/v1_short-urls_shorten.json

@@ -6,7 +6,7 @@
             "Short URLs"
         ],
         "summary": "Create a short URL",
-        "description": "Creates a short URL in a single API call. Useful for third party integrations.",
+        "description": "**[Deprecated]** Use [Create short URL](#/Short%20URLs/createShortUrl) instead",
         "parameters": [
             {
                 "$ref": "../parameters/version.json"