API-Beschreibung

Der folgende Abschnitt beschreibt die vom JSON Data Interface zur Verfügung gestellten Möglichkeiten mit Hilfe von kurzen Beispielanfragen und -antworten. Die API gilt gleichermaßen für den Zugriff mittels MQTT oder mittels ADS.

Typ	Request/Response	Beispiel des JSON-Payloads
Lesen einer Variablen	Request	{"symbol":"MAIN.nCounter"}
	Response	{"symbol":"MAIN.nCounter","value":42}
Lesen einer Variablen und ihres Datentyps	Request	{"symbol":"MAIN.nCounter","datatype":null}
	Response	{"symbol":"MAIN.nCounter","value":42,"datatype":INT}
Gleichzeitiges Lesen mehrerer Variablen	Request	[{"symbol":"MAIN.nCounter"},{"symbol":"MAIN.nSecCounter"}]
	Response	[{"symbol":"MAIN.nCounter","value":42 },{"symbol":"MAIN.nSecCounter","value":35}]
Lesen der TwinCAT-Symbolik	Request	{"symbols":null}
	Response	komplette TwinCAT-Symbolik
Schreiben einer Variablen	Request	{"symbol":"MAIN.nCounter","value":42}
	Response	{"symbol":"MAIN.nCounter","value":42}
Schreiben mehrerer Variablen	Request	[{"symbol":"MAIN.nCounter","value":42},{"symbol":"MAIN.nSecCounter","value":35}]
	Response	[{"symbol":"MAIN.nCounter","value":42},{"symbol":"MAIN.nSecCounter","value":35}]
Methodenaufrufe, optional mit Ein- und Ausgabeparametern	Request	{"symbol":"MAIN.fbTester#M_Add","parameter":{"intA":42, "intB":35}}
	Response	{"symbol":"MAIN.fbTester#M_Add","value":77}
	Response mit zusätzlichen Ausgabeparametern	{"symbol":"MAIN.fbTester#M_Add","value":77,"parameter":{"intC":32, "intD":64}}