View source for API List Cameras

This API provides a list of all currently configured cameras.

===Resource URL===
<pre>http://valt.example.com/api/v3/admin/cameras</pre>

===Resource Information===
{|class="wikitable"
|'''Method'''
|GET
|-
|'''Response Type'''
|JSON
|-
|'''Authentication Required'''
|Yes
|}

===Parameters===

No parameters can be passed to this call.

===Response===

{|class="wikitable"
!Code
!Reason
|-
|200
|Request Successful
|-
|401
|Unauthorized
|}

{|class="wikitable"
|+JSON Response
!colspan="4"|data
|-
|colspan="3"|'''cameras'''
|Array of cameras
|-
|
|colspan="2"|'''id'''
|Camera ID
|-
|
|colspan="2"|'''name'''
|Camera Name
|-
|
|colspan="2"|'''type'''
|Device Type: Camera or Device (ipad, iphone, card reader)
|-
|
|colspan="2"|'''device_type'''
|Device Type: Camera or Device (ipad, iphone, card reader)
|-
|
|colspan="2"|'''ip'''
|IP Address or FQDN of the camera
|-
|
|colspan="2"|'''http_port'''
|Port used for camera control.
|-
|
|colspan="2"|'''rtsp_port'''
|Port used for pulling the video stream from the camera.
|-
|
|colspan="2"|'''username'''
|Username to access the camera.
|-
|
|colspan="2"|'''password'''
|Password to access the camera.
|-
|
|colspan="2"|'''brand'''
|Camera Brand (Axis or Epiphan)
|-
|
|colspan="2"|'''model'''
|Camera Model Type (Usually Axis-1)
|-
|
|colspan="2"|'''wowza'''
|Media server camera is assigned to.
|-
|
|
|'''id'''
|Media Server ID Number
|-
|
|
|'''name'''
|Media Server Name
|-
|
|
|'''address'''
|Media Server IP Address or FQDN
|-
|
|
|'''port'''
|Port used for streaming video from server to client.
|-
|
|
|'''ssl'''
|true = video stream encrypted, false = video stream not encrypted
|-
|
|
|'''storage_folder'''
|Folder where video files are stored under /usr/local/WowaStreamingEngine/content/
|-
|
|colspan="2"|'''color'''
|Color for camera control interface in VALT
|-
|
|colspan="2"|'''colo_hex'''
|Hex code for color value above.
|-
|
|colspan="2"|'''rooms'''
|Array of rooms the camera is assigned to.
|-
|
|
|'''id'''
|Room ID
|-
|
|
|'''name'''
|Room Name
|}

==Examples==
===Request===
<pre>https://ivstest1.ad.ipivs.com/api/v3/admin/cameras?access_token=exampletoken</pre>

===Successful Response===
Sample response is shown with line breaks to make it more readable. Actual responses will not include line breaks.
 <nowiki>
{
"data":{
"cameras":[
{
"id": 52,
"name": "P5414-E",
"type": "camera",
"device_type": "camera",
"ip": "192.168.7.20",
"http_port": 80,
"rtsp_port": 554,
"username": "root",
"password": "admin51",
"brand": "Axis",
"model": "Axis-1",
"wowza":{"id": 1, "name": "localhost", "address": "ivstest1.ad.ipivs.com", "port": 444,…},
"color": "white",
"colo_hex": "#ffffff",
"rooms":[{"id": 40, "name": "Wall PTZ" }]
},
{
"id": 53,
"name": "P3365",
"type": "camera",
"device_type": "camera",
"ip": "192.168.7.21",
"http_port": 80,
"rtsp_port": 554,
"username": "root",
"password": "admin51",
"brand": "Axis",
"model": "Axis-1",
"wowza":{"id": 1, "name": "localhost", "address": "ivstest1.ad.ipivs.com", "port": 444,…},
"color": "white",
"colo_hex": "#ffffff",
"rooms":[{"id": 39, "name": "Fixed Dome" }]
},
{
"id": 54,
"name": "P3374-V",
"type": "camera",
"device_type": "camera",
"ip": "192.168.7.24",
"http_port": 80,
"rtsp_port": 554,
"username": "root",
"password": "admin51",
"brand": "Axis",
"model": "Axis-1",
"wowza":{"id": 1, "name": "localhost", "address": "ivstest1.ad.ipivs.com", "port": 444,…},
"color": "white",
"colo_hex": "#ffffff",
"rooms":[{"id": 39, "name": "Fixed Dome" }]
},
{
"id": 55,
"name": "P3364",
"type": "camera",
"device_type": "camera",
"ip": "192.168.7.27",
"http_port": 80,
"rtsp_port": 554,
"username": "root",
"password": "admin51",
"brand": "Axis",
"model": "Axis-1",
"wowza":{"id": 1, "name": "localhost", "address": "ivstest1.ad.ipivs.com", "port": 444,…},
"color": "white",
"colo_hex": "#ffffff",
"rooms":[{"id": 39, "name": "Fixed Dome" }]
}
]
}
}
</nowiki>

===Failure Response===
<pre>{"error":{"code":401,"message":"No API key provided"}}</pre>