209 lines
5.8 KiB
JSON
209 lines
5.8 KiB
JSON
{
|
|
"openapi": "3.0.0",
|
|
"info": {
|
|
"title": "TAO Test Taker API",
|
|
"version": "2.0"
|
|
},
|
|
"paths": {
|
|
"/taoTestTaker/api/testTakers": {
|
|
"post": {
|
|
"summary": "Create new test taker",
|
|
"requestBody": {
|
|
"content": {
|
|
"application/x-www-form-urlencoded": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/taoTestTaker.TestTaker.New"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"responses": {
|
|
"200": {
|
|
"description": "Test taker created",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"properties": {
|
|
"success": {
|
|
"description": "`false` on failure, `true` on success",
|
|
"type": "boolean"
|
|
},
|
|
"uri": {
|
|
"description": "Created test taker URI",
|
|
"type": "string"
|
|
},
|
|
"version": {
|
|
"description": "Platform version",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"example": {
|
|
"success": true,
|
|
"uri": "http://sample/first.rdf#i1536680377163171"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid request data",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "#/components/schemas/tao.RestTrait.FailureResponse"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"components": {
|
|
"schemas": {
|
|
"taoTestTaker.TestTaker.New": {
|
|
"required": [
|
|
"login",
|
|
"password",
|
|
"userLanguage"
|
|
],
|
|
"properties": {
|
|
"login": {
|
|
"description": "Login",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"type": "object",
|
|
"allOf": [
|
|
{
|
|
"$ref": "#/components/schemas/tao.GenerisClass.Search"
|
|
},
|
|
{
|
|
"$ref": "#/components/schemas/taoTestTaker.TestTaker.Update"
|
|
}
|
|
]
|
|
},
|
|
"taoTestTaker.TestTaker.Update": {
|
|
"properties": {
|
|
"label": {
|
|
"description": "Label",
|
|
"type": "string"
|
|
},
|
|
"login": {
|
|
"description": "Login",
|
|
"type": "string"
|
|
},
|
|
"password": {
|
|
"description": "Password",
|
|
"type": "string"
|
|
},
|
|
"userLanguage": {
|
|
"description": "Interface language (uri or language code, 'fr-FR' or 'http://www.tao.lu/Ontologies/TAO.rdf#Langfr-FR' for example)",
|
|
"type": "string"
|
|
},
|
|
"defaultLanguage": {
|
|
"description": "Default language (uri or language code, 'fr-FR' or 'http://www.tao.lu/Ontologies/TAO.rdf#Langfr-FR' for example)",
|
|
"type": "string"
|
|
},
|
|
"firstName": {
|
|
"description": "First name",
|
|
"type": "string"
|
|
},
|
|
"lastName": {
|
|
"description": "Last name",
|
|
"type": "string"
|
|
},
|
|
"mail": {
|
|
"description": "Email",
|
|
"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.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.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.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.RestTrait.BaseResponse": {
|
|
"properties": {
|
|
"success": {
|
|
"description": "Indicates error",
|
|
"type": "boolean"
|
|
},
|
|
"version": {
|
|
"description": "Build version",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"type": "object"
|
|
}
|
|
}
|
|
}
|
|
} |