Aliez.tv API
Our project allows you to receive data about your channels trough this API.
In order to use this feature you need a unique API key that can be obtained here http://aliez.tv/devkey/.
How does the API work
Requests to the API are made through HTTP and the GET method. Responses are sent using JSON.
Request overview:
http://aliez.tv/api/api.php?m=METHOD&PARAMETERS&key=API_KEY
Methods
getChannelInfo – getting information about the channel
You can transfer as parameter either the numeric id (id), or its short name (titleshort),
that is displayed as URL on the channel page.
Response contains:
cid – numeric id
title – full title
titleshort – short title
status – status (online or offline)
viewers – number of viewers (refreshed once per minute)
bitrate – bitrate in kilobits per second
Request example:
http://aliez.tv/api/api.php?m=getChannelInfo&id=17&key=45-abcdefgh1234567890
http://aliez.tv/api/api.php?m=getChannelInfo&titleshort=livestreamingchannel1&key=45-abcdefgh1234567890
Response example:
{"cid":"17", "title":"Live Streaming Channe l1", "titleshort":"livestreamingchannel1",
"status":"online", "viewers":"2342" "bitrate":"548"}
Error codes
method – an invalid or not supported method was entered
options – not all required parameters were entered
nodata – there is no data for the requested objects (you may have entered an invalid id)
key – incorrect API key
internal – internal system error
unknown – unknown error
Response example:
{"error":"nodata"}
|
|
