Disco service API

The Disco service provides an HTTP API for third party web sites. It provides the stream information for the users.

Given that this API controls access to important resources from the Genvid services, it is secured with a security code in its header. You should only call this code from a trusted server and so route it back from a web server instead of accessing it directly from the web client.

HTTP header

Each request needs to add the following headers.

Listing 1 Example header
GET /myrequest HTTP/1.0
secret: secretcodeprovidedbyus

The token is obtain by using the /disco/user/create method

GET /disco/stream/info

Get the information about the current stream.

Listing 2 Example response
{
   "name": "The stream name",
   "game": "The game name",
   "nbViewers": 10000
}

POST /disco/stream/join

Ask the service to join the stream for a user and return the connection information.

Listing 3 Example response
{
   "uri": "http://anuri.com:12345"
}