Merge pull request #601 from kwv/fixes-594

Fixes 594 -- Allows default content-type (application/octet-stream) on path based parameter operations

doc/API.md

@@ -287,7 +287,7 @@ POST /api/v1/user/devices/{serial}/remoteConnect
 Using cURL:
 
 ```bash
-curl -X POST --header "Content-Type: application/json" -H "Authorization: Bearer YOUR-TOKEN-HERE" https://stf.example.org/api/v1/user/devices/{serial}/remoteConnect
+curl -X POST -H "Authorization: Bearer YOUR-TOKEN-HERE" https://stf.example.org/api/v1/user/devices/{serial}/remoteConnect
 ```
 
 Using Node.js:
@@ -384,7 +384,7 @@ function add_device
 
 function remote_connect
 {
-    response=$(curl -X POST -H "Content-Type: application/json" \
+    response=$(curl -X POST \
                  -H "Authorization: Bearer $STF_TOKEN" \
                 $STF_URL/api/v1/user/devices/$DEVICE_SERIAL/remoteConnect)
 
@@ -404,7 +404,7 @@ function remote_connect
 
 function remove_device
 {
-    response=$(curl -X DELETE -H "Content-Type: application/json" \
+    response=$(curl -X DELETE \
                  -H "Authorization: Bearer $STF_TOKEN" \
                 $STF_URL/api/v1/user/devices/$DEVICE_SERIAL)
 

lib/units/api/swagger/api_v1.yaml

@@ -1,6 +1,6 @@
 swagger: "2.0"
 info:
-  version: "2.0.0"
+  version: "2.3.0"
   title: Smartphone Test Farm
   description: Control and manages real Smartphone devices from browser and restful apis
   license:
@@ -16,6 +16,7 @@ schemes:
   - https
 consumes:
   - application/json
+  - application/octet-stream
 produces:
   - application/json
 tags:

lib/units/api/swagger/api_v1_generated.json

@@ -1,7 +1,7 @@
 {
   "swagger": "2.0",
   "info": {
-    "version": "2.0.0",
+    "version": "2.3.0",
     "title": "Smartphone Test Farm",
     "description": "Control and manages real Smartphone devices from browser and restful apis",
     "license": {
@@ -20,7 +20,8 @@
     "https"
   ],
   "consumes": [
-    "application/json"
+    "application/json",
+    "application/octet-stream"
   ],
   "produces": [
     "application/json"
@@ -37,6 +38,7 @@
   ],
   "paths": {
     "/user": {
+      "x-swagger-router-controller": "user",
       "get": {
         "summary": "User Profile",
         "description": "The User Profile endpoint returns information about current authorized user",
@@ -66,6 +68,7 @@
       }
     },
     "/user/devices": {
+      "x-swagger-router-controller": "user",
       "get": {
         "summary": "User Devices",
         "description": "The User Devices endpoint returns device list owner by current authorized user",
@@ -139,6 +142,7 @@
       }
     },
     "/user/devices/{serial}": {
+      "x-swagger-router-controller": "user",
       "get": {
         "summary": "User Device",
         "description": "The devices enpoint return information about device owned by user",
@@ -217,6 +221,7 @@
       }
     },
     "/user/devices/{serial}/remoteConnect": {
+      "x-swagger-router-controller": "user",
       "post": {
         "summary": "Remote Connect",
         "description": "The device connect endpoint will request stf server to connect remotely",
@@ -288,6 +293,7 @@
       }
     },
     "/user/accessTokens": {
+      "x-swagger-router-controller": "user",
       "get": {
         "summary": "Access Tokens",
         "description": "The Access Tokens endpoints returns titles of all the valid access tokens",
@@ -317,6 +323,7 @@
       }
     },
     "/devices": {
+      "x-swagger-router-controller": "devices",
       "get": {
         "summary": "Device List",
         "description": "The devices endpoint return list of all the STF devices including Disconnected and Offline",
@@ -355,6 +362,7 @@
       }
     },
     "/devices/{serial}": {
+      "x-swagger-router-controller": "devices",
       "get": {
         "summary": "Device Information",
         "description": "The device enpoint return information about a single device",
@@ -399,7 +407,9 @@
         ]
       }
     },
-    "/swagger.json": {}
+    "/swagger.json": {
+      "x-swagger-pipe": "swagger_raw"
+    }
   },
   "definitions": {
     "UserResponse": {