Differences

This shows you the differences between two versions of the page.

--- documentation:api-http-websockets [2014-01-15 12:55] – [Command: subscribe] nkukard
+++ documentation:api-http-websockets [2014-01-16 15:36] (current) – [Command: subscribe] nkukard
@@ Line 1: / Line 1: @@
 ====== HTTP WebSockets Interface ======
+===== JSON Encapsulation =====
+All JSON responses are encapsulated within a status structure.
+Success:
+<code>
+{
+  status: 'success',
+  data: $data
+}
+</code>
+Errors:
+<code>
+{
+  status: 'error',
+  message: 'error string'
+}
+</code>
 ===== Command Interface =====
@@ Line 20: / Line 39: @@
 ==== Command: subscribe ====
-The subscribe command subscribes a WebSocket to receive periodic statistical updates. The $tag value will be used while streaming statistics (see [[api-data-types#typeotsstreamedjsonstats|OTSStreamedJsonStats]]).
+The subscribe command subscribes a WebSocket to receive periodic statistical updates. The $tag value will be used while streaming statistics (see [[api-data-types#typeotsjsonstats|OTSJsonStats]]).
 Command format:
 <code>
-$tag SUBSCRIBE <type=$item> [type2=$item2] [typeX=$itemX]
+$tag SUBSCRIBE <$type=$item> [$type2=$item2] [$typeX=$itemX]
 </code>
+The value for tag:
+  * The value for tag designates the tag of returned data in the above datatype.
 Possible values for type:
@@ Line 32: / Line 54: @@
   * class
     * Refers to statistics regarding a class. The following is available in the $item field...
-      * Class:$interfaceGroupID,$classID
+      * Class:$interfaceGroupID:$classID
   * basic
     * Refers to a basic counter. The following basic counters are available in the $item field...
@@ Line 41: / Line 63: @@
 ==== Command: unsubscribe ====
-Syntax: unsubscribe <tag>
+WIP
+Command format:
+<code>
+$tag UNSUBSCRIBE
+</code>