aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSun Howwrongbum <sun@adrenosapient.com>2016-12-06 03:31:58 +0530
committerSun Howwrongbum <sun@adrenosapient.com>2016-12-06 03:31:58 +0530
commita0375c8e3067f74ed14c370b2674ea00e9851a9c (patch)
tree04e5f84e07e1f02158cb91d3ab1bac9766cc5a57
parentb7083d62bae0675e2f3e4009e6794460554352d6 (diff)
downloadtraccar-server-a0375c8e3067f74ed14c370b2674ea00e9851a9c.tar.gz
traccar-server-a0375c8e3067f74ed14c370b2674ea00e9851a9c.tar.bz2
traccar-server-a0375c8e3067f74ed14c370b2674ea00e9851a9c.zip
[swagger] Describe /groups and refactor params
... as references
-rw-r--r--swagger.json98
1 files changed, 30 insertions, 68 deletions
diff --git a/swagger.json b/swagger.json
index 61ebf62e7..abdbbf0dc 100644
--- a/swagger.json
+++ b/swagger.json
@@ -48,16 +48,10 @@
"description": "Without any params, returns a list of the user's devices",
"parameters": [
{
- "name": "all",
- "in": "query",
- "description": "Can only be used by admin users to fetch all entities",
- "type": "boolean"
+ "$ref": "#/parameters/all"
},
{
- "name": "userId",
- "in": "query",
- "description": "Standard users can use this with their only with their own _userId_",
- "type": "integer"
+ "$ref": "#/parameters/userId"
}
],
"responses": {
@@ -202,30 +196,19 @@
},
"/groups": {
"get": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
+ "summary": "Fetch a list of Groups",
+ "description": "Without any params, returns a list of the Groups the user belongs to",
"parameters": [
{
- "name": "all",
- "in": "query",
- "required": true,
- "type": "boolean"
+ "$ref": "#/parameters/all"
},
{
- "name": "userId",
- "in": "query",
- "required": true,
- "type": "integer"
+ "$ref": "#/parameters/userId"
}
],
"responses": {
"200": {
"description": "OK",
- "headers": {},
"schema": {
"type": "array",
"items": {
@@ -236,12 +219,7 @@
}
},
"post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
+ "summary": "Create a Group",
"parameters": [
{
"name": "body",
@@ -255,28 +233,22 @@
"responses": {
"200": {
"description": "OK",
- "headers": {},
"schema": {
"$ref": "#/definitions/Group"
}
+ },
+ "400": {
+ "description": "No permission"
}
}
}
},
"/groups/{id}": {
"put": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
+ "summary": "Update a Group",
"parameters": [
{
- "name": "id",
- "in": "path",
- "required": true,
- "type": "integer"
+ "$ref": "#/parameters/entityId"
},
{
"name": "body",
@@ -290,7 +262,6 @@
"responses": {
"200": {
"description": "OK",
- "headers": {},
"schema": {
"$ref": "#/definitions/Group"
}
@@ -298,36 +269,22 @@
}
},
"delete": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
+ "summary": "Delete a Group",
"parameters": [
{
- "name": "id",
- "in": "path",
- "required": true,
- "type": "integer"
+ "$ref": "#/parameters/entityId"
}
],
"responses": {
"204": {
- "description": "No Content",
- "headers": {}
+ "description": "No Content"
}
}
}
},
"/groups/geofences": {
"post": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
+ "summary": "Link a Geofence to a Group",
"parameters": [
{
"name": "body",
@@ -341,7 +298,6 @@
"responses": {
"200": {
"description": "OK",
- "headers": {},
"schema": {
"$ref": "#/definitions/GroupGeofence"
}
@@ -349,12 +305,7 @@
}
},
"delete": {
- "consumes": [
- "application/json"
- ],
- "produces": [
- "application/json"
- ],
+ "summary": "Remove a Geofence from a Group",
"parameters": [
{
"name": "body",
@@ -367,8 +318,7 @@
],
"responses": {
"204": {
- "description": "No Content",
- "headers": {}
+ "description": "No Content"
}
}
}
@@ -1908,6 +1858,18 @@
"in": "path",
"required": true,
"type": "integer"
+ },
+ "all": {
+ "name": "all",
+ "in": "query",
+ "description": "Can only be used by admin users to fetch all entities",
+ "type": "boolean"
+ },
+ "userId": {
+ "name": "userId",
+ "in": "query",
+ "description": "Standard users can use this with their only with their own _userId_",
+ "type": "integer"
}
}
}