API List Room Cameras
Revision as of 13:52, 14 April 2020 by IVSWikiBlue (talk | contribs) (Created page with "This API provides camera details for a specified room. ===Resource URL=== <pre>http://valt.example.com/api/v3/admin/rooms/{roomid}/cameras</pre> ''Replace {roomid} with the a...")
This API provides camera details for a specified room.
Contents
Resource URL
http://valt.example.com/api/v3/admin/rooms/{roomid}/cameras
Replace {roomid} with the actual id number of the room. Rooms are numbered sequentially when added to VALT.
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 |
404 | Room ID Not Found |
data | |||
---|---|---|---|
cameras | Array of cameras assigned to the room. | ||
id | Camera ID | ||
name | Camera Name | ||
type | Device Type: Camera or Device (ipad, iphone, card reader) | ||
device_type | Device Type: Camera or Device (ipad, iphone, card reader) | ||
ip | IP Address or FQDN of the camera | ||
http_port | Port used for camera control. | ||
rtsp_port | Port used for pulling the video stream from the camera. | ||
username | Username to access the camera. | ||
password | Password to access the camera. | ||
brand | Camera Brand (Axis or Epiphan) | ||
model | Camera Model Type (Usually Axis-1) | ||
wowza | Media server camera is assigned to. | ||
id | Media Server ID Number | ||
name | Media Server Name | ||
color | Color for camera control interface in VALT | ||
colo_hex | Hex code for color value above. |
Examples
Request
https://ivstest1.ad.ipivs.com/api/v3/admin/rooms/37/cameras?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":{ "cameras":[ { "id": 63, "name": "P5635-E Mk II", "type": "camera", "device_type": "camera", "ip": "192.168.7.37", "http_port": 80, "rtsp_port": 554, "username": "root", "password": "admin51", "brand": "Axis", "model": "Axis-1", "wowza":{"id": 1, "name": "localhost"}, "color": "white", "colo_hex": "#ffffff" } ] } }
Failure Response
{"error":{"code":401,"message":"No API key provided"}}