Web Pipe
Sportsbook Core
About Us
Contact Us
Products . Web Pipe . Documentation Sign In
Web Pipe Documentation

API is very simple and consists of three commands. Both request and reply must be in JSON format. Websocket protocol is used.

Request commandComment

Subscribe to channel. When subscribed, the client will listen for the channel and receive all the messages broadcasted to this chanel.

		"subscribe": "channel_name"


Unsubscribe from channel. Client will not receive messages from this channel any more.

		"unsubscribe": "channel_name"


Broadcast message to clients subscribed to the channel.

		"broadcast": "channel_name"

Server will broadcast the JSON onject as is, without any changes. So, you may add as many other fields to the JSON object as needed.

		"broadcast": "channel_name",
		"greeting": "Hello, world!",
		"baz": {
			"foo": "bar"

Server will execute above commands silently. No reply will be sent to the given command.


Channel name is any UTF-8 string. Maximum length of the channel name is not limited. But for better performance, the name must be as short as possible.

Advanced use cases

The want_reply field may be specified if client want to receive server reply.

		"unsubscribe": "channel_name_2",
		"want_reply": 1

In this case server will reply to client with the following:

		"action": "unsubscribe",
		"success": false,
		"channel": "channel_name_2"

Field nameComment
actionAction name: subscribe, unsubscribe or broadcast.
successBoolean. Result of the command execution. False does not mean "error". Client was not subscribed to the channel in the above example.
channelString. Channel name.
errorString. Short description of the error.
Regular HTTP POST protocol may be used for broadcasting. Here is a python example:

	#!/usr/bin/env python3

	from urllib.request import Request, urlopen
	import json

	payload_js = {"broadcast":"test_channel", "foo":"bar", "want_reply":1}
	payload_txt = str.encode(json.dumps(payload_js))
	url = ""
		request = Request(url, payload_txt)
		res = urlopen(request).read().decode('utf8').strip()
	except BaseException as err:
		print('Exception: ', err)
The above code will form and send to WebPipe server the following HTTP request:

	POST / HTTP/1.1
	Content-Length: 60

	{"broadcast": "test_channel", "foo": "bar", "want_reply": 1}
Sample Code

Consumer example.
When executed, the code below will connect to the WebPipe server and subscribes to the channel XYZ.

	// address of WebPipe server
	var url = "ws://";

	// Connect to server
	var sock = new WebSocket(url);

	sock.onopen = function( evt ) {
		var p1 = {
			"subscribe": "XYZ",
			"debug": 1
		// convert JSON object to string
		var js = JSON.stringify( p1 );
		// Subscribe to channel named XYZ
		sock.send( js );

	sock.onmessage = function( evt ) {
		// All the events published to the channel
		// XYZ will be logged to developer console.
		console.log( );

Publisher example.
When executed, the object p2 will be sent to all subscribers of XYZ channel.

	// Address of WebPipe server
	var url = "ws://";

	// Connect to server
	var sock = new WebSocket(url);

	sock.onopen = function( evt ) {
		var p2 = {
			"broadcast": "XYZ",
			"foo": {
				"bar": true
		// convert JSON object to string
		var js = JSON.stringify( p2 );
		// Send data to all clients subscribed to XYZ
		sock.send( js );
Password protected channels

In control panel you may specify a password for creating new channels.

		"subscribe": "channel_name",
		"password": "secret",
		"want_reply": 1

Everything will work as described above if the password is correct. In case of incorrect password, the client will receive the following reply:

	{	"action": "subscribe",
		"success": false,
		"channel": "channel_name",
		"error": "Wrong password"

Password is not required in case if channel already exists. The following code will successfuly subscribe to channel if it was created earlier either with or without password:

		"subscribe": "exsisting_channel_name"

Direct messaging

Right after connection to server, the client receives the following greeting message with private channel name:

		"my_channel": "CLBDIUHED83"

Private channel name will not change during the session and will be re-generated when the same client re-connects to server.

Other clients may send direct messages to this specific client using its private channel name.

This is your responsibility to invent the way to broadcast private channel name to other clients :-)

Description   |   Download
mobile version Copyright © 1999-2023 SoftCab, Inc. All Rights Reserved ·