252 lines
6.4 KiB
JSON
252 lines
6.4 KiB
JSON
{
|
|
"openapi": "3.0.0",
|
|
"info": {
|
|
"title": "TAO Rest API",
|
|
"version": "1.0"
|
|
},
|
|
"paths": {
|
|
"tao/api/users": {
|
|
"post": {
|
|
"summary": "Create new user",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/x-www-form-urlencoded": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/tao.User.New"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "User created",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/tao.CommonRestModule.CreatedResourceResponse"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid request data",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/tao.RestTrait.FailureResponse"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"/tao/RestVersion": {
|
|
"get": {
|
|
"tags": [
|
|
"platform"
|
|
],
|
|
"operationId": "getVersion",
|
|
"responses": {
|
|
"200": {
|
|
"description": "Returns current platform version",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"example": {
|
|
"version": "3.3.0-sprint97"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"components": {
|
|
"schemas": {
|
|
"tao.CommonRestModule.CreatedResource": {
|
|
"description": "Created resource data",
|
|
"properties": {
|
|
"uriResource": {
|
|
"description": "Method to wrap creating to service",
|
|
"type": "string",
|
|
"example": "http://sample/first.rdf#i1536680377163171"
|
|
},
|
|
"label": {
|
|
"description": "Method to wrap creating to service",
|
|
"type": "string"
|
|
},
|
|
"comment": {
|
|
"description": "Method to wrap creating to service",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"tao.CommonRestModule.CreatedResourceResponse": {
|
|
"description": "Created resource data",
|
|
"properties": {
|
|
"data": {
|
|
"$ref": "#/components/schemas/tao.CommonRestModule.CreatedResource"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"allOf": [
|
|
{
|
|
"$ref": "#/components/schemas/tao.RestTrait.BaseResponse"
|
|
}
|
|
]
|
|
},
|
|
"tao.GenerisClass.Search": {
|
|
"properties": {
|
|
"class-uri": {
|
|
"description": "Target class uri",
|
|
"type": "string"
|
|
},
|
|
"class-label": {
|
|
"description": "Target class label. If label is not unique first match will be used",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"tao.GenerisClass.New": {
|
|
"properties": {
|
|
"class-label": {
|
|
"description": "Class label",
|
|
"type": "string"
|
|
},
|
|
"class-comment": {
|
|
"description": "Class comment",
|
|
"type": "string"
|
|
},
|
|
"parent-class-uri": {
|
|
"description": "Parent class uri, root class by default",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"tao.RestTrait.BaseResponse": {
|
|
"properties": {
|
|
"success": {
|
|
"description": "Indicates error",
|
|
"type": "boolean"
|
|
},
|
|
"version": {
|
|
"description": "Build version",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"tao.RestTrait.FailureResponse": {
|
|
"description": "Error response with success=false",
|
|
"properties": {
|
|
"success": {
|
|
"description": "Indicates error",
|
|
"type": "boolean",
|
|
"example": false
|
|
},
|
|
"errorCode": {
|
|
"description": "Exception error code",
|
|
"type": "integer"
|
|
},
|
|
"errorMsg": {
|
|
"description": "Exception message, not localized",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"allOf": [
|
|
{
|
|
"$ref": "#/components/schemas/tao.RestTrait.BaseResponse"
|
|
}
|
|
]
|
|
},
|
|
"tao.RestTrait.SuccessResponse": {
|
|
"description": "Response with data and success=true",
|
|
"properties": {
|
|
"success": {
|
|
"description": "Indicates success",
|
|
"type": "boolean",
|
|
"example": true
|
|
},
|
|
"data": {
|
|
"description": "Payload",
|
|
"type": "object"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"allOf": [
|
|
{
|
|
"$ref": "#/components/schemas/tao.RestTrait.BaseResponse"
|
|
}
|
|
]
|
|
},
|
|
"tao.User.New": {
|
|
"required": [
|
|
"login",
|
|
"password",
|
|
"userLanguage",
|
|
"roles"
|
|
],
|
|
"properties": {
|
|
"login": {
|
|
"description": "Login",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"allOf": [
|
|
{
|
|
"$ref": "#/components/schemas/tao.GenerisClass.Search"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/tao.User.Update"
|
|
}
|
|
]
|
|
},
|
|
"tao.User.Update": {
|
|
"properties": {
|
|
"login": {
|
|
"description": "Login",
|
|
"type": "string"
|
|
},
|
|
"password": {
|
|
"description": "Password",
|
|
"type": "string"
|
|
},
|
|
"userLanguage": {
|
|
"description": "Interface language uri",
|
|
"type": "string"
|
|
},
|
|
"defaultLanguage": {
|
|
"description": "Default language uri",
|
|
"type": "string"
|
|
},
|
|
"firstName": {
|
|
"description": "First name",
|
|
"type": "string"
|
|
},
|
|
"lastName": {
|
|
"description": "Last name",
|
|
"type": "string"
|
|
},
|
|
"mail": {
|
|
"description": "Email",
|
|
"type": "string"
|
|
},
|
|
"roles": {
|
|
"description": "List of roles (URIs)",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"type": "object"
|
|
}
|
|
}
|
|
}
|
|
}
|