Documents API documentation version v1
Application_URL/services/api/v1
About Documents
Documents are additional details that you can attach, such as design documents, instructions, manuals and tutorials.
Purpose
This API allows you to upload, update and assign/unassign documents to other objects.
/document({documentID})/associated
This endpoint get all the associated objects for a document.
get /document({documentID})/associated
This endpoint get all the associated objects for a document.
URI Parameters
- documentID: required (string)
HTTP status code 200
gets associated objects of a document.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"assignedModels": [{
"modelID": {
"type": "string",
"maxLength": 32
},
"templateID": {
"type": "string",
"maxLength": 32
},
"modelName": {
"type": "string",
"maxLength": 255
},
"modelVersion": {
"type": "string",
"maxLength": 5
}
}],
"assignedInstructions": [{
"instructionID": {
"type": "string",
"maxLength": 32
},
"instructionName": {
"type": "string",
"maxLength": 255
},
"instructionVersion": {
"type": "string",
"maxLength": 5
},
"instructionType": {
"type": "string"
}
}],
"assignedSteps": [{
"instructionID": {
"type": "string",
"maxLength": 32
},
"instructionVersion": {
"type": "string",
"maxLength": 5
},
"instructionName": {
"type": "string",
"maxLength": 255
},
"stepID": {
"type": "string",
"maxLength": 32
},
"stepName": {
"type": "string",
"maxLength": 255
}
}],
"assignedAnnouncements": [{
"announcementID": {
"type": "string",
"maxLength": 32
},
"announcementName": {
"type": "string",
"maxLength": 255
},
"announcementVersion": {
"type": "string",
"maxLength": 5
},
"announcementType": {
"type": "string"
},
"status": {
"type": "string",
"maxLength": 1
}
}],
"assignedEquipments": [{
"equipmentID": {
"type": "string",
"maxLength": 32
},
"equipmentName": {
"type": "string",
"maxLength": 255
},
"equipmentVersion": {
"type": "string",
"maxLength": 5
},
"status": {
"type": "string",
"maxLength": 1
}
}],
"assignedFunctionalLocations": [{
"functionalLocationID": {
"type": "string",
"maxLength": 32
},
"FLVersion": {
"type": "string",
"maxLength": 5
},
"name": {
"type": "string",
"maxLength": 255
},
"functionalLocationStatusCode": {
"type": "string",
"maxLength": 1
}
}],
"assignedImprovementCases": [{
"id": {
"type": "string",
"maxLength": 32
},
"name": {
"type": "string",
"maxLength": 255
},
"status": {
"type": "string",
"maxLength": 5
}
}]
}
}Example:
{
"assignedModels": [],
"assignedInstructions": [{
"instructionID": "48ED1FC79AB441DF97F5D2F8A9208568",
"instructionName": "ihihihhi",
"instructionVersion": "0.0",
"instructionType": "5",
"status": "1"
}],
"assignedSteps": [{
"instructionID": "D5EC7D89EC534F88B1EBF954B412E76C",
"instructionVersion": "0.0",
"stepID": "2196EEE8B22C4092802D4CC8F29C9F85",
"stepName": "2"
}],
"assignedAnnouncements": [],
"assignedEquipments": []
}HTTP status code 400
Bad request, document doesn't exists.
HTTP status code 403
User is not authorized to download the document.
HTTP status code 500
Internal Server Error.
/document
This endpoint allows you to upload document links by setting content-type to application/json in request header.
post /document/upload
This endpoint allows you to upload document links by setting content-type to application/json in request header.
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {},
"id": "http://example.com/example.json",
"properties": {
"categoryCode": {
"id": "/properties/categoryCode",
"type": "string"
},
"description": {
"id": "/properties/description",
"type": "string"
},
"link": {
"id": "/properties/link",
"type": "string"
},
"phaseCode": {
"id": "/properties/phaseCode",
"type": "string"
},
"title": {
"id": "/properties/title",
"type": "string"
},
"languageCode": {
"id": "/properties/languageCode",
"type": "string"
}
},
"type": "object"
}Example:
{
"link": "https://example.com",
"title": "Example title",
"phaseCode": "2/3/4",
"categoryCode": "1",
"description": "An example website",
"languageCode": "en"
}HTTP status code 200
The document was uploaded.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {},
"id": "http://example.com/example.json",
"properties": {
"categoryCode": {
"id": "/properties/categoryCode",
"type": "string"
},
"categoryCodeDesc": {
"id": "/properties/categoryCodeDesc",
"type": "string"
},
"client": {
"id": "/properties/client",
"type": "null"
},
"description": {
"id": "/properties/description",
"type": "string"
},
"extension": {
"id": "/properties/extension",
"type": "string"
},
"externalDocumentlink": {
"id": "/properties/externalDocumentlink",
"type": "string"
},
"fileSize": {
"id": "/properties/fileSize",
"type": "integer"
},
"fileSizeUnit": {
"id": "/properties/fileSizeUnit",
"type": "null"
},
"hashKey": {
"id": "/properties/hashKey",
"type": "null"
},
"id": {
"id": "/properties/id",
"type": "string"
},
"internalID": {
"id": "/properties/internalID",
"type": "string"
},
"isMarkedForDeletion": {
"id": "/properties/isMarkedForDeletion",
"type": "string"
},
"languageCode": {
"id": "/properties/languageCode",
"type": "string"
},
"languageCodeDescription": {
"id": "/properties/languageCodeDescription",
"type": "string"
},
"mimeType": {
"id": "/properties/mimeType",
"type": "string"
},
"phaseCode": {
"id": "/properties/phaseCode",
"type": "string"
},
"phaseCodeDesc": {
"id": "/properties/phaseCodeDesc",
"type": "string"
},
"repositoryDocumentID": {
"id": "/properties/repositoryDocumentID",
"type": "null"
},
"resolution": {
"id": "/properties/resolution",
"type": "null"
},
"source": {
"id": "/properties/source",
"type": "string"
},
"tenantID": {
"id": "/properties/tenantID",
"type": "null"
},
"title": {
"id": "/properties/title",
"type": "string"
},
"url": {
"id": "/properties/url",
"type": "null"
},
"confidentiality": {
"id": "/properties/confidentiality",
"type": "null"
}
},
"type": "object"
}Example:
{
"client": null,
"internalID": "DOC.TEDX.3900",
"id": "29A7354F8CA844C58C898DCE1BF59421",
"tenantID": null,
"phaseCode": "3/2/4",
"categoryCode": "6",
"phaseCodeDesc": "Maintenance",
"categoryCodeDesc": "Inspection / Preventive Maintenance / Testing / Calibration",
"isMarkedForDeletion": "0",
"url": null,
"extension": "ELINK",
"resolution": null,
"languageCode": "en",
"languageCodeDescription": "English",
"repositoryDocumentID": null,
"description": "connecting frnds",
"title": "facebook",
"hashKey": null,
"mimeType": "ELINK",
"fileSize": 0.0,
"fileSizeUnit": null,
"externalDocumentlink": "https://facebook.com",
"source": "Operator"
}HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This endpoint allows you to upload document links in other languages against a main document link, by setting content-type to application/json in request header.
post /document/upload/otherlang
This endpoint allows you to upload document links in other languages against a main document link, by setting content-type to application/json in request header.
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {},
"id": "http://example.com/example.json",
"properties": {
"description": {
"id": "/properties/description",
"type": "string"
},
"documentId": {
"id": "/properties/documentId",
"type": "string"
},
"languageCode": {
"id": "/properties/languageCode",
"type": "string"
},
"link": {
"id": "/properties/link",
"type": "string"
},
"title": {
"id": "/properties/title",
"type": "string"
}
},
"type": "object"
}Example:
{
"documentId": "E83643A4707B489BB9B8D08FB619207C",
"link": "http://abcd.com",
"title": "abcd",
"languageCode": "fr",
"description": ""
}HTTP status code 200
The document was uploaded.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {},
"id": "http://example.com/example.json",
"properties": {
"categoryCode": {
"id": "/properties/categoryCode",
"type": "string"
},
"categoryCodeDesc": {
"id": "/properties/categoryCodeDesc",
"type": "string"
},
"client": {
"id": "/properties/client",
"type": "null"
},
"description": {
"id": "/properties/description",
"type": "string"
},
"extension": {
"id": "/properties/extension",
"type": "string"
},
"externalDocumentlink": {
"id": "/properties/externalDocumentlink",
"type": "string"
},
"fileSize": {
"id": "/properties/fileSize",
"type": "integer"
},
"fileSizeUnit": {
"id": "/properties/fileSizeUnit",
"type": "null"
},
"hashKey": {
"id": "/properties/hashKey",
"type": "null"
},
"id": {
"id": "/properties/id",
"type": "string"
},
"internalID": {
"id": "/properties/internalID",
"type": "string"
},
"isMarkedForDeletion": {
"id": "/properties/isMarkedForDeletion",
"type": "string"
},
"languageCode": {
"id": "/properties/languageCode",
"type": "string"
},
"languageCodeDescription": {
"id": "/properties/languageCodeDescription",
"type": "string"
},
"mimeType": {
"id": "/properties/mimeType",
"type": "string"
},
"phaseCode": {
"id": "/properties/phaseCode",
"type": "string"
},
"phaseCodeDesc": {
"id": "/properties/phaseCodeDesc",
"type": "string"
},
"repositoryDocumentID": {
"id": "/properties/repositoryDocumentID",
"type": "null"
},
"resolution": {
"id": "/properties/resolution",
"type": "null"
},
"source": {
"id": "/properties/source",
"type": "string"
},
"tenantID": {
"id": "/properties/tenantID",
"type": "null"
},
"title": {
"id": "/properties/title",
"type": "string"
},
"url": {
"id": "/properties/url",
"type": "null"
},
"confidentiality": {
"id": "/properties/confidentiality",
"type": "null"
}
},
"type": "object"
}Example:
{
"documentId": "E0E4B4B1F084478692B50B6B6C33BDC8",
"title": "pump.vds",
"phaseCode": "3/6",
"categoryCode": "6",
"mimeType": "application/octet-stream",
"description": "pump",
"fileSize": "5824554",
"fileSizeUnit": "1",
"canHotSpot": "0",
"languageCode": "bg"
}HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This endpoint allows you to update phase code, category code and description properties associated with a document.
put /document/update
This endpoint allows you to update phase code, category code and description properties associated with a document.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string",
"maxLength": 100
},
"phaseCode": {
"type": "string",
"maxLength": 10
},
"categoryCode": {
"type": "string",
"maxLength": 10
},
"description": {
"type": "string",
"maxLength": 5000
}
}
}Example:
[{
"documentId": "2986CA2368A34527BB760F7597936634",
"phaseCode": "8/2/4",
"categoryCode": "18"
}]
HTTP status code 200
Successfully updates the document.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentId": {
"type": "string",
"maxLength": 100
},
"phaseCode": {
"type": "string",
"maxLength": 10
},
"categoryCode": {
"type": "string",
"maxLength": 10
},
"description": {
"type": "string",
"maxLength": 5000
}
}
}Example:
[{
"documentId": "2986CA2368A34527BB760F7597936634",
"phaseCode": "8/2/4",
"categoryCode": "18"
}]
HTTP status code 400
Bad request, when document or equipment doesn't exists.
HTTP status code 403
User is not authorized to update the document.
HTTP status code 500
Internal Server Error, something unexpected happened.
This endpoint allows you to update language dependent documents document links by setting content-type to application/json in request header.
put /document/update/otherlang
This endpoint allows you to update language dependent documents document links by setting content-type to application/json in request header.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {},
"id": "http://example.com/example.json",
"properties": {
"description": {
"id": "/properties/description",
"type": "string"
},
"link": {
"id": "/properties/link",
"type": "string"
},
"title": {
"id": "/properties/title",
"type": "string"
}
},
"type": "object"
}
Example:
{
"description": "please change the link",
"title": "facebook",
"link": "https://facebook.com"
}HTTP status code 200
The document was uploaded.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {},
"id": "http://example.com/example.json",
"properties": {
"categoryCode": {
"id": "/properties/categoryCode",
"type": "string"
},
"categoryCodeDesc": {
"id": "/properties/categoryCodeDesc",
"type": "string"
},
"client": {
"id": "/properties/client",
"type": "null"
},
"description": {
"id": "/properties/description",
"type": "string"
},
"extension": {
"id": "/properties/extension",
"type": "string"
},
"externalDocumentlink": {
"id": "/properties/externalDocumentlink",
"type": "string"
},
"fileSize": {
"id": "/properties/fileSize",
"type": "integer"
},
"fileSizeUnit": {
"id": "/properties/fileSizeUnit",
"type": "null"
},
"hashKey": {
"id": "/properties/hashKey",
"type": "null"
},
"id": {
"id": "/properties/id",
"type": "string"
},
"internalID": {
"id": "/properties/internalID",
"type": "string"
},
"isMarkedForDeletion": {
"id": "/properties/isMarkedForDeletion",
"type": "string"
},
"languageCode": {
"id": "/properties/languageCode",
"type": "string"
},
"languageCodeDescription": {
"id": "/properties/languageCodeDescription",
"type": "string"
},
"mimeType": {
"id": "/properties/mimeType",
"type": "string"
},
"phaseCode": {
"id": "/properties/phaseCode",
"type": "string"
},
"phaseCodeDesc": {
"id": "/properties/phaseCodeDesc",
"type": "string"
},
"repositoryDocumentID": {
"id": "/properties/repositoryDocumentID",
"type": "null"
},
"resolution": {
"id": "/properties/resolution",
"type": "null"
},
"source": {
"id": "/properties/source",
"type": "string"
},
"tenantID": {
"id": "/properties/tenantID",
"type": "null"
},
"title": {
"id": "/properties/title",
"type": "string"
},
"url": {
"id": "/properties/url",
"type": "null"
},
"confidentiality": {
"id": "/properties/confidentiality",
"type": "null"
}
},
"type": "object"
}Example:
{
"canHotSpot": null,
"docId": "01923DF3820447848A2A9A00CDBC1BF6",
"name": "attachmentList.txt",
"type": "text/plain",
"size": "34630.0",
"fileSizeUnit": "1",
"description": "updateAttachment1"
}HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
This endpoint is used to delete documents with all its language dependent documents.
delete /document/delete
This endpoint is used to delete documents with all its language dependent documents.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {},
"id": "http://example.com/example.json",
"properties": {
"ID": {
"id": "/properties/ID",
"type": "string"
},
"elink": {
"id": "/properties/elink",
"type": "boolean"
},
"lang": {
"id": "/properties/lang",
"items": {
"id": "/properties/lang/items",
"type": "string"
},
"type": "array"
}
},
"type": "object"
}Example:
[{
"ID": "CB9D8D11C64C453FBCBDF19C40B3A9AC",
"elink":false
},
{
"ID": "9C67F85CAFC34179B0C8B00C1F347B1A",
"elink":false
}]
This endpoint is used to delete language related documents.
delete /document/delete/otherlang
This endpoint is used to delete language related documents.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {},
"id": "http://example.com/example.json",
"properties": {
"ID": {
"id": "/properties/ID",
"type": "string"
},
"elink": {
"id": "/properties/elink",
"type": "boolean"
},
"lang": {
"id": "/properties/lang",
"items": {
"id": "/properties/lang/items",
"type": "string"
},
"type": "array"
}
},
"type": "object"
}Example:
{
"ID": "7711F2FFCC76408CA15079D7577482E6",
"lang": ["en","hr","de"],
"elink":false
}
This method is used to assign model(s) to document(s).
post /document/assign/model
This method is used to assign model(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to assign announcement(s) to document(s).
post /document/assign/announcement
This method is used to assign announcement(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to assign step(s) to document(s).
post /document/assign/steps
This method is used to assign step(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to assign equipment(s) to document(s).
post /document/assign/equipment
This method is used to assign equipment(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to assign functional location(s) to document(s).
post /document/assign/functionallocation
This method is used to assign functional location(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to assign Performace Improvement Case(s) to document(s).
post /document/assign/improvementcase
This method is used to assign Performace Improvement Case(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"assigneeType": {
"type": "String",
"maxLength": 2
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"85109AD5453C45B0A3A302820FB6B85C",
"assigneeID":"067A405ED9ED423296DD010523D0DC99",
"assigneeType":"10"
},
{
"documentID":"85109AD5453C45B0A3A302820FB6B85C",
"assigneeID":"067A405ED9ED423296DD010523D0DC99",
"assigneeType":"11"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to assign Model(s) to document(s).
post /document/assign/modelrequest
This method is used to assign Model(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {},
"id": "http://example.com/example.json",
"properties": {
"documentIDMapping": {
"id": "/properties/documentIDMapping",
"items": {
"id": "/properties/documentIDMapping/items",
"properties": {
"assigneeID": {
"id": "/properties/documentIDMapping/items/properties/assigneeID",
"type": "string"
},
"documentID": {
"id": "/properties/documentIDMapping/items/properties/documentID",
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}Example:
{
"documentIDMapping":[
{
"documentID":"85109AD5453C45B0A3A302820FB6B85C",
"assigneeID":"067A405ED9ED423296DD010523D0DC99"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to assign Spare Parts(s) to document(s).
post /document/assign/sparepart
This method is used to assign Spare Parts(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to unassign model(s) to document(s).
post /document/unassign/model
This method is used to unassign model(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to unassign announcement(s) to document(s).
post /document/unassign/announcement
This method is used to unassign announcement(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to unassign step(s) to document(s).
post /document/unassign/steps
This method is used to unassign step(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to unassign equipment(s) to document(s).
post /document/unassign/equipment
This method is used to unassign equipment(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to unassign functional location(s) to document(s).
post /document/unassign/functionallocation
This method is used to unassign functional location(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to unassign Performace Improvement Case(s) to document(s).
post /document/unassign/improvementcase
This method is used to unassign Performace Improvement Case(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"assigneeType": {
"type": "String",
"maxLength": 2
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"85109AD5453C45B0A3A302820FB6B85C",
"assigneeID":"067A405ED9ED423296DD010523D0DC99",
"assigneeType":"10"
},
{
"documentID":"85109AD5453C45B0A3A302820FB6B85C",
"assigneeID":"067A405ED9ED423296DD010523D0DC99",
"assigneeType":"11"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to unassign SparePart(s) to document(s).
post /document/unassign/sparepart
This method is used to unassign SparePart(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"documentIDMapping": {
"items": {
"additionalProperties": false,
"properties": {
"documentID": {
"type": "string",
"maxLength": 100
},
"assigneeID": {
"type": "string",
"maxLength": 32
},
"version": {
"type": "number"
}
}
}
}
}
}Example:
{
"documentIDMapping":[
{
"documentID":"Ou0hibM2xkZ1tTD6pvTsEYH2kinRsGMpeK_yHcfZ1F8",
"assigneeID":"DA725A38663748D78F2EDF6861DC80B9",
"version":"0.0"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method is used to unassign model request(s) to document(s).
post /document/unassign/modelrequest
This method is used to unassign model request(s) to document(s).
REST API supports Basic Authentication
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"definitions": {},
"id": "http://example.com/example.json",
"properties": {
"documentIDMapping": {
"id": "/properties/documentIDMapping",
"items": {
"id": "/properties/documentIDMapping/items",
"properties": {
"assigneeID": {
"id": "/properties/documentIDMapping/items/properties/assigneeID",
"type": "string"
},
"documentID": {
"id": "/properties/documentIDMapping/items/properties/documentID",
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}Example:
{
"documentIDMapping":[
{
"documentID":"85109AD5453C45B0A3A302820FB6B85C",
"assigneeID":"067A405ED9ED423296DD010523D0DC99"
}
]
}HTTP status code 204
No Content.
HTTP status code 400
Bad request, Some error while uploading the file.
HTTP status code 500
Internal Server Error, something unexpected happened.
Secured by basic
This method get all the valid phase and category.
get /document/getPhaseCategory
This method get all the valid phase and category.
HTTP status code 200
gets valid phase and category mapping.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"phaseCode": [{
"Type": {
"type": "string",
"maxLength": 100
},
"Code": {
"type": "string",
"maxLength": 1
},
"LanguageISOCode": {
"type": "string",
"maxLength": 2
},
"Description": {
"type": "string"
}
}],
"categoryCode": [{
"Type": {
"type": "string",
"maxLength": 100
},
"Code": {
"type": "string",
"maxLength": 1
},
"LanguageISOCode": {
"type": "string",
"maxLength": 2
},
"Description": {
"type": "string"
}
}]
}
}
Example:
{
"phaseCode": [{
"type": "DocumentPhaseCode",
"code": "2",
"languageISOCode": "en",
"description": "Acquisition"
}, {
"type": "DocumentPhaseCode",
"code": "6",
"languageISOCode": "en",
"description": "Decommissioning"
}, {
"type": "DocumentPhaseCode",
"code": "1",
"languageISOCode": "en",
"description": "Design"
}, {
"type": "DocumentPhaseCode",
"code": "7",
"languageISOCode": "en",
"description": "Dismantle"
}, {
"type": "DocumentPhaseCode",
"code": "8",
"languageISOCode": "en",
"description": "Disposal"
}, {
"type": "DocumentPhaseCode",
"code": "3",
"languageISOCode": "en",
"description": "Installation"
}, {
"type": "DocumentPhaseCode",
"code": "5",
"languageISOCode": "en",
"description": "Maintenance"
}, {
"type": "DocumentPhaseCode",
"code": "4",
"languageISOCode": "en",
"description": "Operation"
}],
"categoryCode": [{
"type": "DocumentCategory",
"code": "4",
"languageISOCode": "en",
"description": "Bills of Materials"
}, {
"type": "DocumentCategory",
"code": "5",
"languageISOCode": "en",
"description": "Certificates"
}, {
"type": "DocumentCategory",
"code": "11",
"languageISOCode": "en",
"description": "Commercial Documents"
}, {
"type": "DocumentCategory",
"code": "10",
"languageISOCode": "en",
"description": "Corrective Maintenance / Repair"
}, {
"type": "DocumentCategory",
"code": "3",
"languageISOCode": "en",
"description": "Drawings / Schemes"
}, {
"type": "DocumentCategory",
"code": "1",
"languageISOCode": "en",
"description": "Identification"
}, {
"type": "DocumentCategory",
"code": "9",
"languageISOCode": "en",
"description": "Inspection / Preventive Maintenance / Testing / Calibration"
}, {
"type": "DocumentCategory",
"code": "6",
"languageISOCode": "en",
"description": "Installation / Dismantling"
}, {
"type": "DocumentCategory",
"code": "7",
"languageISOCode": "en",
"description": "Operation"
}, {
"type": "DocumentCategory",
"code": "12",
"languageISOCode": "en",
"description": "Others"
}, {
"type": "DocumentCategory",
"code": "8",
"languageISOCode": "en",
"description": "Safety"
}, {
"type": "DocumentCategory",
"code": "2",
"languageISOCode": "en",
"description": "Technical Specification"
}]
}HTTP status code 400
Bad request.
HTTP status code 500
Internal Server Error.
This endpoint is deprecated due to introduction of no dependency of category on phase. Please refer to the new method /getPhaseCategory for updated phase and category.
get /document/getPhaseCategoryMapping
This endpoint is deprecated due to introduction of no dependency of category on phase. Please refer to the new method /getPhaseCategory for updated phase and category.
HTTP status code 200
gets valid phase and category mapping.
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-4/schema",
"type": "object",
"additionalProperties": false,
"properties": {
"phaseCode": [{
"Type": {
"type": "string",
"maxLength": 100
},
"Code": {
"type": "string",
"maxLength": 1
},
"LanguageISOCode": {
"type": "string",
"maxLength": 2
},
"Description": {
"type": "string"
}
}],
"categoryCode": [{
"Type": {
"type": "string",
"maxLength": 100
},
"Code": {
"type": "string",
"maxLength": 1
},
"LanguageISOCode": {
"type": "string",
"maxLength": 2
},
"Description": {
"type": "string"
}
}]
}
}
Example:
{
"phaseCatMap": [{
"phaseCode": "3",
"phaseDescription": "Installation",
"phaseCategoryMappingList": [{
"code": "6",
"description": "Commissioning Plan"
}, {
"code": "9",
"description": "Handover Checklist"
}, {
"code": "7",
"description": "Installation Certification"
}, {
"code": "8",
"description": "Startup Results"
}]
}, {
"phaseCode": "2",
"phaseDescription": "Acquisition",
"phaseCategoryMappingList": [{
"code": "4",
"description": "Installation Plan"
}, {
"code": "5",
"description": "Services Catalog"
}]
}, {
"phaseCode": "1",
"phaseDescription": "Design",
"phaseCategoryMappingList": [{
"code": "1",
"description": "Engineering Drawing"
}, {
"code": "3",
"description": "P&ID"
}, {
"code": "2",
"description": "Specifications"
}]
}, {
"phaseCode": "7",
"phaseDescription": "Dismantle",
"phaseCategoryMappingList": [{
"code": "17",
"description": "Dismantling Guide"
}]
}, {
"phaseCode": "6",
"phaseDescription": "Decommissioning",
"phaseCategoryMappingList": [{
"code": "15",
"description": "Decommissioning Checklist"
}, {
"code": "14",
"description": "Decommissioning Plan"
}, {
"code": "16",
"description": "Decommissioning Report"
}]
}, {
"phaseCode": "5",
"phaseDescription": "Maintenance",
"phaseCategoryMappingList": [{
"code": "13",
"description": "Inspection Manual"
}, {
"code": "11",
"description": "Maintenance Manual"
}, {
"code": "12",
"description": "Visualization"
}]
}, {
"phaseCode": "4",
"phaseDescription": "Operation",
"phaseCategoryMappingList": [{
"code": "10",
"description": "Operations Manual"
}, {
"code": "19",
"description": "Software"
}]
}, {
"phaseCode": "8",
"phaseDescription": "Disposal",
"phaseCategoryMappingList": [{
"code": "18",
"description": "Waste Management Guide"
}]
}]
}HTTP status code 400
Bad request.
HTTP status code 500
Internal Server Error.
/documents
This endpoint allows you to search for document based on filter query parameter.
get /documents
This endpoint allows you to search for document based on filter query parameter.
REST API supports Basic Authentication
Query Parameters
- $filter: (string)
Retrieves documents based on the value provided. This parameter follows ODATA URL covention. For eg $filter=(substringof('CombustionEngine', name) eq true)
- $top: (string)
Top 'n' documents in the list. This parameter follows ODATA URL convention. You must use this query parameter with $skip, $top alone will not work. For eg $top=10.
- $skip: (string)
Number of documents to be skipped in the list. This parameter follows ODATA URL convention. You must use this query parameter with $top, $skip alone will not work. For eg $skip=20
- $orderby: (string)
Order the list of documents based on the fields. This parameter follows ODATA URL covention. For eg $orderby=internalId asc
HTTP status code 200
Search result based on query parameters
Body
Type: application/json
Schema:
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "array",
"items": {
"type": "object",
"properties": {
"internalId": {
"type": "string"
},
"documentId": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"phaseCode": {
"type": "string"
},
"categoryCode": {
"type": "string"
},
"phaseCodeDescription": {
"type": "string"
},
"categoryCodeDescription": {
"type": "string"
},
"source": {
"type": "string"
},
"fileSize": {
"type": "string"
},
"mimeGroup": {
"type": "string"
},
"languageCode": {
"type": "string"
},
"languageDescription": {
"type": "string"
},
"associatedLanguage": {
"type": "string"
},
"canHotSpot": {
"type": "string"
},
"createdOn": {
"type": "string"
},
"changedOn": {
"type": "string"
}
}
}
}Example:
[
{
"internalId": "D.TEDX.6728",
"documentId": "2D2B9F3814414A0A9E544969A1674083",
"title": "AINDocument",
"description": "AINDocument",
"phaseCode": "2",
"categoryCode": "1",
"phaseCodeDescription": "Acquisition",
"categoryCodeDescription": "Identification",
"source": "SAP Operator 1",
"fileSize": "53 KB",
"mimeGroup": "Text Document",
"languageCode": "de",
"languageDescription": "German",
"associatedLanguage": "de",
"canHotSpot": "0",
"createdOn": "2017-01-31",
"changedOn": "2017-01-31"
}
]HTTP status code 400
The request could not be understood by the server due to malformed syntax.You SHOULD NOT repeat the request without modifications