BazeField Services

<back to all web services

DomainPointsSubscribeRequest

Domain Data API
Requires Authentication
The following routes are available for this service:
GET, POST/api/objects/points/subscribeRegisters a subscription. Returns handle id and current value for all schemas and points
GET, POST/api/objects/{ObjectIds}/points/{points}/subscribeObsolete
DomainPointsSubscribeRequest Parameters:
NameParameterData TypeRequiredDescription
ObjectIdspathList<string>No
PointspathList<string>No
FieldsbodyList<string>No
EnableBufferingbodyboolNo
RequestedSamplingRatebodyint?No
SubscriptionPingRatebodyint?No
ClientRequestHandlebodystringNo
mdmidsbodyList<string>No
DomainPointsSubscribeResponse Parameters:
NameParameterData TypeRequiredDescription
ResultformDictionary<string, DomainPointValues>No
ServerSubcriptionHandleformstringNo
BazefieldResponse Parameters:
NameParameterData TypeRequiredDescription
ReplyInfoformReplyInfoNo
ReplyInfo Parameters:
NameParameterData TypeRequiredDescription
RcvTimeformdoubleNo
ReplyTimeformdoubleNo
ClientRequestHandleformstringNo
ErrorformstringNo
DomainPointValues Parameters:
NameParameterData TypeRequiredDescription
PointsformDictionary<string, ObjectPointValueLocal>No
ObjectPointValueLocal Parameters:
NameParameterData TypeRequiredDescription
AttributesformDictionary<string, string>No
ObjectPointValue Parameters:
NameParameterData TypeRequiredDescription
PointNameformstringNo
ObjectIdformstringNo
TimeSeriesValue Parameters:
NameParameterData TypeRequiredDescription
tformlongNo
qformintNo
vformObjectNo
t_localformDateTimeOffset?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/objects/points/subscribe HTTP/1.1 
Host: mdn.bazefield.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	objectIds: 
	[
		String
	],
	points: 
	[
		String
	],
	fields: 
	[
		String
	],
	enableBuffering: False,
	requestedSamplingRate: 0,
	subscriptionPingRate: 0,
	clientRequestHandle: String,
	mdmids: 
	[
		String
	]
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	result: 
	{
		String: 
		{
			points: 
			{
				String: 
				{
					attributes: 
					{
						String: String
					},
					pointName: String,
					objectId: String,
					t: 0,
					q: 0,
					v: {},
					t_local: 0001-01-01T00:00:00.0000000+00:00
				}
			}
		}
	},
	serverSubcriptionHandle: String,
	replyInfo: 
	{
		rcvTime: 0,
		replyTime: 0,
		clientRequestHandle: String,
		error: String
	}
}