IVSWikiBlue: Created page with "This API provides details for a specified room. ===Resource URL===

http://valt.example.com/api/v3/admin/rooms/{roomid}

''Replace {roomid} with the actual id number..."

2020-04-14T19:51:09Z

Created page with "This API provides details for a specified room. ===Resource URL=== <pre>http://valt.example.com/api/v3/admin/rooms/{roomid}</pre> ''Replace {roomid} with the actual id number..."

New page

This API provides details for a specified room.

===Resource URL===
<pre>http://valt.example.com/api/v3/admin/rooms/{roomid}</pre>
''Replace {roomid} with the actual id number of the room. Rooms are numbered sequentially when added to VALT.''

===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
|-
|404
|Room ID Not Found
|}

{|class="wikitable"
|+JSON Response
!colspan="3"|data
|-
|colspan="2"|'''id'''
|Room ID Number
|-
|colspan="2"|'''name'''
|Room Name
|-
|colspan="2"|'''is_io'''
|True = IO Recording is enabled, False = IO Recording is not enabled
|-
|colspan="2"|'''io_camera_id'''
|ID of Camera designated for IO control (only returned if is_io is equal to true).
|-
|colspan="2"|'''io_user_id'''
|ID of user IO recordings will be assigned to (only returned if is_io is equal to true).
|-
|colspan="2"|'''cameras'''
|Array of cameras assigned to the room.
|-
|
|'''id'''
|Camera ID
|-
|
|'''name'''
|Camera Name
|-
|
|'''type'''
|Device Type: Camera or Device (ipad, iphone, card reader)
|}

==Examples==
===Request===
<pre>https://ivstest1.ad.ipivs.com/api/v3/admin/rooms/37?access_token=e82632d19c523678fea3d1016c6df9e9</pre>

===Successful Response===
Sample response is shown with line breaks to make it more readable. Actual responses will not include line breaks.
<nowiki>
{
"data":{
"id": 37,
"name": "Test",
"is_io": false,
"cameras":[
{
"id": 63,
"name": "P5635-E Mk II",
"type": "camera"
}
]
}
}
</nowiki>

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

API Room Details - Revision history

IVSWikiBlue: Created page with "This API provides details for a specified room. ===Resource URL===
http://valt.example.com/api/v3/admin/rooms/{roomid}
''Replace {roomid} with the actual id number..."