API Application Information
Revision as of 13:21, 14 April 2020 by IVSWikiBlue (talk | contribs) (Created page with "The application information API provides general information about the VALT application including current build version and media server status. ===Resource URL=== <pre>http...")
The application information API provides general information about the VALT application including current build version and media server status.
Contents
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 |
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"}}