Commit 47846e2c authored by canterafonsj's avatar canterafonsj
Browse files

Fixing enumeration

parent 6602d101
...@@ -141,7 +141,7 @@ ...@@ -141,7 +141,7 @@
}, },
"geometry": { "geometry": {
"type": "string", "type": "string",
"enumeration": [ "enum": [
"Point", "Point",
"MultiPoint", "MultiPoint",
"LineString", "LineString",
...@@ -152,7 +152,7 @@ ...@@ -152,7 +152,7 @@
}, },
"timerel": { "timerel": {
"type": "string", "type": "string",
"enumeration": [ "enum": [
"before", "before",
"after", "after",
"between" "between"
......
{ {
"openapi": "3.0.1", "openapi": "3.0.1",
"info": { "info": {
"title": "NGSI-LD Entities", "title": "NGSI-LD Entity Operations",
"version": "latest" "version": "0.1"
}, },
"components": { "components": {},
"parameters": { "paths": {
"id": { "/entityOperations/create": {
"name": "id", "post": {
"description": "Comma separated list of URIs to be retrieved", "description": "Batch Entity creation",
"in": "query", "operationId": "batchEntityCreation",
"required": false, "requestBody": {
"required": true,
"content": {
"application/json;application/ld+json": {
"schema": { "schema": {
"type": "string", "$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/EntityList.json#/definitions/EntityList"
"format": "uri"
} }
},
"type": {
"name": "type",
"description": "Comma separated list of Entity type names to be retrieved",
"in": "query",
"required": false,
"schema": {
"type": "string",
"minLength": 1
} }
},
"idPattern": {
"name": "idPattern",
"description": "Regular expression that must be matched by Entity ids",
"in": "query",
"required": false,
"schema": {
"type": "string",
"format": "regexp"
} }
}, },
"attrs": { "responses": {
"name": "attrs", "200": {
"description": "Comma separated list of attribute names (properties or relationships) to be retrieved", "description": "Success",
"in": "query", "content": {
"required": false, "application/json;application/ld+json": {
"schema": { "schema": {
"type": "string", "$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/BatchOperationResult.json#/definitions/BatchOperationResult"
"minLength": 1
} }
},
"q": {
"name": "q",
"description": "Query",
"in": "query",
"required": false,
"schema": {
"type": "string",
"minLength": 1
} }
},
"georel": {
"name": "georel",
"description": "Geo-relationship",
"in": "query",
"required": false,
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/common.json#/definitions/georel"
} }
}, },
"geometry": { "400": {
"name": "geometry", "description": "Bad request",
"description": "Geometry", "content": {
"in": "query", "application/json;application/ld+json": {
"required": false,
"schema": { "schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/common.json#/definitions/geometry" "$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/common.json#/definitions/ProblemDetails"
}
} }
},
"coordinates": {
"name": "coordinates",
"description": "Coordinates serialized as a string",
"in": "query",
"required": false,
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/common.json#/definitions/coordinates"
} }
},
"geoproperty": {
"name": "geoproperty",
"description": "The name of the property that contains the geo-spatial data that will be used to resolve the geoquery",
"in": "query",
"required": false,
"schema": {
"type": "string",
"minLength": 1
} }
},
"csf": {
"name": "csf",
"description": "Context Source Filter",
"in": "query",
"required": false,
"schema": {
"type": "string",
"minLength": 1
} }
},
"limit": {
"name": "limit",
"description": "Pagination limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 1
} }
}, },
"options":{ "/entityOperations/update": {
"post": {
"description": "Batch Entity update",
"operationId": "batchEntityUpdate",
"parameters": [
{
"name": "options", "name": "options",
"description": "Options dictionary",
"in": "query", "in": "query",
"required": false, "required": false,
"schema": { "schema": {
"type": "string", "type": "string",
"enum": ["keyValues", "sysAttrs"] "enum": [
"noOverwrite"
]
} }
} }
],
"requestBody": {
"required": true,
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/EntityList.json#/definitions/EntityList"
} }
},
"paths": {
"/entities/": {
"get": {
"description": "Retrieve a set of entities which matches a specific query from an NGSI-LD system",
"operationId": "queryEntities",
"parameters": [
{
"$ref": "#/components/parameters/id"
},
{
"$ref": "#/components/parameters/idPattern"
},
{
"$ref": "#/components/parameters/type"
},
{
"$ref": "#/components/parameters/attrs"
},
{
"$ref": "#/components/parameters/q"
},
{
"$ref": "#/components/parameters/georel"
},
{
"$ref": "#/components/parameters/geometry"
},
{
"$ref": "#/components/parameters/coordinates"
},
{
"$ref": "#/components/parameters/geoproperty"
},
{
"$ref": "#/components/parameters/csf"
},
{
"$ref": "#/components/parameters/limit"
},
{
"$ref": "#/components/parameters/options"
} }
], }
},
"responses": { "responses": {
"200": { "200": {
"description": "OK", "description": "Success",
"content": { "content": {
"application/json;application/ld+json": { "application/json;application/ld+json": {
"schema": { "schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/EntityList.json#/definitions/EntityList" "$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/BatchOperationResult.json#/definitions/BatchOperationResult"
},
"examples": {
"simple": {
"externalValue": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/examples/EntityList-example.json"
}
} }
} }
} }
...@@ -195,23 +93,46 @@ ...@@ -195,23 +93,46 @@
} }
} }
} }
}
}, },
"/entityOperations/upsert": {
"post": { "post": {
"description": "Create a new Entity within an NGSI-LD system", "description": "Batch Entity upsert",
"operationId": "createEntity", "operationId": "batchEntityUpsert",
"parameters": [
{
"name": "options",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"replace",
"update"
]
}
}
],
"requestBody": { "requestBody": {
"required": true, "required": true,
"content": { "content": {
"application/json;application/ld+json": { "application/json;application/ld+json": {
"schema": { "schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/Entity.json#/definitions/Entity" "$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/EntityList.json#/definitions/EntityList"
} }
} }
} }
}, },
"responses": { "responses": {
"201": { "200": {
"description": "Created. Contains the resource URI of the created Entity" "description": "Success",
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/BatchOperationResult.json#/definitions/BatchOperationResult"
}
}
}
}, },
"400": { "400": {
"description": "Bad request", "description": "Bad request",
...@@ -222,19 +143,42 @@ ...@@ -222,19 +143,42 @@
} }
} }
} }
}
}
}
}, },
"409": { "/entityOperations/delete": {
"description": "Already exists", "post": {
"description": "Batch Entity delete",
"operationId": "batchEntityDelete",
"requestBody": {
"required": true,
"content": { "content": {
"application/json;application/ld+json": { "application/json;application/ld+json": {
"schema": { "schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/common.json#/definitions/ProblemDetails" "type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1
}
}
}
},
"responses": {
"200": {
"description": "Success",
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/BatchOperationResult.json#/definitions/BatchOperationResult"
} }
} }
} }
}, },
"422": { "400": {
"description": "Unprocessable Entity", "description": "Bad request",
"content": { "content": {
"application/json;application/ld+json": { "application/json;application/ld+json": {
"schema": { "schema": {
......
...@@ -2,10 +2,9 @@ ...@@ -2,10 +2,9 @@
"openapi": "3.0.1", "openapi": "3.0.1",
"info": { "info": {
"title": "NGSI-LD Entity Operations", "title": "NGSI-LD Entity Operations",
"version": "latest" "version": "0.1"
},
"components": {
}, },
"components": {},
"paths": { "paths": {
"/entityOperations/create": { "/entityOperations/create": {
"post": { "post": {
...@@ -41,16 +40,155 @@ ...@@ -41,16 +40,155 @@
} }
} }
} }
}, }
} }
} }
}, },
"/entityOperations/update": { "/entityOperations/update": {
"post": {
"description": "Batch Entity update",
"operationId": "batchEntityUpdate",
"parameters": [
{
"name": "options",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"noOverwrite"
]
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/EntityList.json#/definitions/EntityList"
}
}
}
},
"responses": {
"200": {
"description": "Success",
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/BatchOperationResult.json#/definitions/BatchOperationResult"
}
}
}
},
"400": {
"description": "Bad request",
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/common.json#/definitions/ProblemDetails"
}
}
}
}
}
}
}, },
"/entityOperations/upsert": { "/entityOperations/upsert": {
"post": {
"description": "Batch Entity upsert",
"operationId": "batchEntityUpsert",
"parameters": [
{
"name": "options",
"in": "query",
"required": false,
"schema": {
"type": "string",
"enum": [
"replace",
"update"
]
}
}
],
"requestBody": {
"required": true,
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/EntityList.json#/definitions/EntityList"
}
}
}
},
"responses": {
"200": {
"description": "Success",
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/BatchOperationResult.json#/definitions/BatchOperationResult"
}
}
}
},
"400": {
"description": "Bad request",
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/common.json#/definitions/ProblemDetails"
}
}
}
}
}
}
}, },
"/entityOperations/delete": { "/entityOperations/delete": {
"post": {
"description": "Batch Entity delete",
"operationId": "batchEntityDelete",
"requestBody": {
"required": true,
"content": {
"application/json;application/ld+json": {
"schema": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"minItems": 1
}
}
}
},
"responses": {
"200": {
"description": "Success",
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/BatchOperationResult.json#/definitions/BatchOperationResult"
}
}
}
},
"400": {
"description": "Bad request",
"content": {
"application/json;application/ld+json": {
"schema": {
"$ref": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/common.json#/definitions/ProblemDetails"
}
}
}
}
}
}
} }
} }
} }
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment