BazeField Services

<back to all web services

CommentsCreateRequest

Comment API

Create one or more comments for an asset or an alarm/allocation for an asset.

Requires Authentication
The following routes are available for this service:
POST/api/comments
CommentsCreateRequest Parameters:
NameParameterData TypeRequiredDescription
CommentsbodyList<Comment>No
Comment Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
TurbineIdformintNo
TurbineNameformstringNo
TimeStampformDateTimeNo
TextformstringNo
CreatedByformstringNo
CreatedByIdformdecimal?No
LastModifiedformDateTimeNo
TypeformCommentTypeNo
Externalformbool?No
Stickyformbool?No
AllocationIdformint?No
AlarmLogIdformint?No
AlarmIdformint?No
CommandIdformint?No
RelatedInfoformstringNo
ClearedformboolNo
LabelsformList<Label>No
ObjectIdformstringNo
RelatedStartformDateTime?No
RelatedEndformDateTime?No
CommentType Enum:
Turbine
Allocation
Alarm
Label Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
NameformstringNo
ColorformstringNo
TypeformLabelType?No
LabelType Enum:
NameValue
Allocation1
Other2
CommentsCreateResponse Parameters:
NameParameterData TypeRequiredDescription
CommentsformList<Comment>No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/comments HTTP/1.1 
Host: mdn.bazefield.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	comments: 
	[
		{
			id: 0,
			turbineId: 0,
			turbineName: String,
			timeStamp: 0001-01-01,
			text: String,
			createdBy: String,
			createdById: 0,
			lastModified: 0001-01-01,
			type: Turbine,
			external: False,
			sticky: False,
			allocationId: 0,
			alarmLogId: 0,
			alarmId: 0,
			commandId: 0,
			relatedInfo: String,
			cleared: False,
			labels: 
			[
				{
					id: 0,
					name: String,
					color: String,
					type: 0
				}
			],
			objectId: String,
			relatedStart: 0001-01-01,
			relatedEnd: 0001-01-01
		}
	]
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	comments: 
	[
		{
			id: 0,
			turbineId: 0,
			turbineName: String,
			timeStamp: 0001-01-01,
			text: String,
			createdBy: String,
			createdById: 0,
			lastModified: 0001-01-01,
			type: Turbine,
			external: False,
			sticky: False,
			allocationId: 0,
			alarmLogId: 0,
			alarmId: 0,
			commandId: 0,
			relatedInfo: String,
			cleared: False,
			labels: 
			[
				{
					id: 0,
					name: String,
					color: String,
					type: 0
				}
			],
			objectId: String,
			relatedStart: 0001-01-01,
			relatedEnd: 0001-01-01
		}
	]
}