API Update Camera
This API call will update a specified camera.
Contents
Resource URL
http://valt.example.com/api/v3/admin/cameras/{cameraid}/edit
Replace {cameraid} with the actual id number of the camera. Cameras are numbered sequentially when added to VALT.
Resource Information
| Method | POST |
| Headers | Content-Type:application/json |
| Response Type | JSON |
| Authentication Required | Yes |
Parameters
The JSON body must be properly formatted. All fields and values should be enclosed in double quotes and separated by a colon.
| Field Name | Description | Required | Example |
|---|---|---|---|
| name | Camera Name | yes | Camera 1 |
| ip | Camera IP address or FQDN. | yes | 192.168.7.32 |
| camera_type | Device Type: Camera or Device (ipad, iphone, card reader) | no | camera |
| device_type | Device Type: Camera or Device (ipad, iphone, card reader) | no | camera |
| http_port | Port used for camera control. (Default: 80) | no | 80 |
| rtsp_port | Port used for pulling the video stream from the camera. (Default: 554) | no | 554 |
| username | Username to access the camera. | yes | root |
| password | Password to access the camera. | yes | admin51 |
| brand | Camera Brand (should be 1) | yes | 1 |
| model | Camera Model Type (should be 1) | yes | 1 |
| rooms | Array of rooms the camera will be assigned to | no | [37,29] |
| wowza | ID of the media server the camera will be assigned to. | yes | 1 |
Response
| Code | Reason |
|---|---|
| 200 | Camera Created Successfully |
| 400 | Invalid Request (See Response for Specific Error) |
| 401 | Unauthorized |
| 404 | Camera ID Not Found |
| 500 | JSON Body Formatted Incorrectly |
| data | |
|---|---|
| id | ID number for the new camera. |
Examples
Request
The sample JSON body below is formatted with line breaks and indentation to make it easier to read. This is not required.
https://ivstest1.ad.ipivs.com/api/v3/admin/cameras/91/edit?access_token=e82632d19c523678fea3d1016c6df9e9
{
"name":"API Camera",
"ip":"192.168.7.2",
"username":"root",
"password":"admin51",
"wowza":1,
"brand":1,
"model":1,
"rooms":[37,43]
}
Successful Response
Sample response is shown with line breaks to make it more readable. Actual responses will not include line breaks.
{
"data":{
"id": 91
}
}
Failure Response
Sample response is shown with line breaks to make it more readable. Actual responses will not include line breaks.
{
"data":{
"message": "Validation Error",
"fields":[
{
"name": "name",
"message": "This value should not be blank."
}
]
},
"code": 400
}
