diff options
Diffstat (limited to 'swagger.json')
| -rw-r--r-- | swagger.json | 18 |
1 files changed, 14 insertions, 4 deletions
diff --git a/swagger.json b/swagger.json index cdf710c30..25b76963c 100644 --- a/swagger.json +++ b/swagger.json @@ -578,6 +578,8 @@ }, "/positions": { "get": { + "summary" : "Fetches a list of Positions", + "description" : "Without any params, it returns a list of last known positions for all the user's devices", "consumes": [ "application/json" ], @@ -588,27 +590,35 @@ { "name": "deviceId", "in": "query", - "description": "deviceId is optional, but requires the from and to parameters when used", + "description": "_deviceId_ is optional, but requires the _from_ and _to_ parameters when used", "required": false, "type": "integer" }, { "name": "from", "in": "query", + "description": "Not required with _id_", "required": false, "type": "string" }, { "name": "to", "in": "query", + "description": "Not required with _id_", "required": false, "type": "string" + }, { + "name" : "id", + "in" : "query", + "description" : "To fetch one or more positions. Multiple params can be passed like `id=31&id=42`", + "required" : false, + "type" : "integer", + "collectionFormat" : "multi" } ], "responses": { "200": { "description": "OK", - "headers": {}, "schema": { "type": "array", "items": { @@ -756,7 +766,7 @@ "schema": { "type": "array", "items": { - "$ref": "#/definitions/Position" + "$ref": "#/definitions/User" } } } @@ -911,7 +921,7 @@ } }, "/commandtypes": { - "post": { + "get": { "consumes": [ "application/json" ], |