API Application Information

From IVS Wiki
Jump to: navigation, search

The application information API provides general information about the VALT application including current build version and media server status.


Resource URL

http://valt.example.com/api/v3/admin/general

Resource Information

Method GET
Response Type JSON
Authentication Required Yes

Parameters

No parameters can be passed to this call.

Response

Code Reason
200 Request Successful
401 Unauthorized
JSON Response
data
version Current build version of VALT.
media_servers List of all currently configured media servers.
name Media Server Name
address Media server FQDN or IP address.
free_space Free space available on media server.
total Total media server capacity.

Examples

Request

https://ivstest1.ad.ipivs.com/api/v3/admin/general?access_token=e82632d19c523678fea3d1016c6df9e9

Successful Response

Sample response is shown with line breaks to make it more readable. Actual responses will not include line breaks.

{
"data":{
"version": 641,
"media_servers":[
{
"name": "localhost",
"address": "ivstest1.ad.ipivs.com",
"free_space": 62702,
"total": 96633
},
{
"name": "ivstest2.ad.ipivs.com",
"address": "ivstest2.ad.ipivs.com",
"free_space": 83437,
"total": 96633
}
]
}
}

Failure Response

{"error":{"code":401,"message":"No API key provided"}}