API

tinyCam Monitor PRO web server uses API which is partially compatible with Axis IP cameras. You can use any IP camera viewer software to view tinyCam server remotely.

Authentication

By default basic authentication is used. However it is also possible to authenticate by providing credentials as parameters. In both cases it is hardly recommended to use HTTPS connection.

Parameters:

 user=<string>
Username. Optional.

 pwd=<string>
Password. Optional.


Examples:

https://admin:mypassword@192.168.0.3:8083/axis-cgi/mjpg/video.cgi
https://192.168.0.3:8083/axis-cgi/mjpg/video.cgi?user=admin&pwd=mypassword

JPEG and MJPEG video requests

Guest and admin. The /axis-cgi/mjpg/video.cgi is used to request a Motion JPEG video stream with specified arguments. Request /axis-cgi/jpg/image.cgi is used for JPEG.

 http://<servername>/axis-cgi/mjpg/video.cgi[?<argument>=<value>[&<argument>=<value>...]] 
 http://<servername>/axis-cgi/jpg/image.cgi[?<argument>=<value>[&<argument>=<value>...]] 


Parameters:

 camera=<int>
Selects the video source. 1..n. Optional.

 fps=<int>
Image frame rate. 0 - unlimited. Optional.

 compression=<int>
Adjusts the compression level of the image. Higher values correspond to higher compression, that is lower quality and smaller image size. Optional.

 resolution=<string>
Resolution [width]x[height] of the returned image, e.g. 640x480. Optional.


Examples:

http://192.168.0.3:8083/axis-cgi/mjpg/video.cgi
http://192.168.0.3:8083/axis-cgi/jpg/image.cgi
http://192.168.0.3:8083/axis-cgi/mjpg/video.cgi?camera=2&fps=1&compression=80&resolution=320x240
http://192.168.0.3:8083/axis-cgi/jpg/image.cgi?camera=3&compression=50&resolution=480x640
http://pastebin.com/NCWWSQxa (matrix 2x2)

Audio requests

Guest and admin. The /axis-cgi/audio/receive.wav is used to request a WAV audio stream with specified arguments.

 http://<servername>/axis-cgi/audio/receive.wav[?<argument>=<value>[&<argument>=<value>...]] 


Parameters:

 camera=<int>
Selects the audio source. 1..n. Optional.


Examples:

http://192.168.0.3:8083/axis-cgi/audio/receive.wav
http://192.168.0.3:8083/axis-cgi/audio/receive.wav?camera=2

PTZ requests

Admin only. The /axis-cgi/com/ptz.cgi is used to make PTZ request with specified arguments.

 http://<servername>/axis-cgi/com/ptz.cgi[?<argument>=<value>[&<argument>=<value>...]] 


Parameters:

 camera=<int>
Selects the video source. 1..n. Optional.

 continuouspantiltmove=<int>,<int>
Continuous pan/tilt motion. Positive values mean right (pan) and up (tilt), negative values mean left (pan) and down (tilt). "0,0" means stop. Optional.
Values as <pan speed>,<tilt speed>

 continuouszoommove=<int>
Continuous zoom motion. Positive values mean zoom in and negative values mean zoom out. "0" means stop. Optional.

 continuousfocusmmove=<int>
Continuous focus motion. Positive values focus near and negative values mean focus far. "0" means stop. Optional.

 continuousirismmove=<int>
Continuous iris motion. Positive values mean iris open and negative values mean iris close. "0" means stop. Optional.

 move=home
Moves home. Optional.

 gotoserverpresetno=<int>
Move to the position associated with the specified preset position number. 1..n. Optional.


Examples:

http://192.168.0.3:8083/axis-cgi/com/ptz.cgi?move=home
http://192.168.0.3:8083/axis-cgi/com/ptz.cgi?camera=2&gotoserverpresetno=3
http://192.168.0.3:8083/axis-cgi/com/ptz.cgi?continuouspantiltmove=0,0
http://192.168.0.3:8083/axis-cgi/com/ptz.cgi?continuouspantiltmove=100,-100&continuouszoommove=100

Background mode

Admin only. The root.BackgroundMode parameter is used to switch on/off background mode in tinyCam Monitor.

 http://<servername>/param.cgi?action=update&root.BackgroundMode=<string> 


Parameters:

 root.BackgroundMode=<string>
Can be on or off. Mandatory.


Examples:

http://192.168.0.3:8083/param.cgi?action=update&root.BackgroundMode=on
http://192.168.0.3:8083/param.cgi?action=update&root.BackgroundMode=off

Stream profile

Admin only. The root.StreamProfile parameter is used to change stream profile in tinyCam Monitor.

 http://<servername>/param.cgi?action=update&root.StreamProfile=<string> 


Parameters:

 root.StreamProfile=<string>
Can be main, sub or auto. Mandatory.


Examples:

http://192.168.0.3:8083/param.cgi?action=update&root.StreamProfile=main
http://192.168.0.3:8083/param.cgi?action=update&root.StreamProfile=auto

Notificaions

Admin only. The root.Notifications parameter is used to switch on/off notifications in tinyCam Monitor.

 http://<servername>/param.cgi?action=update&root.Notifications=<string>[&tag=<string>] 


Parameters:

 root.Notifications=<string>
Can be on or off. Mandatory.

 tag=<string>
Tag name. Optional. If specified the app sends "Motion Detection On" or "Motion Detection Off" command to all cameras under the tag for changing on-camera motion detection.


Examples:

http://192.168.0.3:8083/param.cgi?action=update&root.Notifications=on
http://192.168.0.3:8083/param.cgi?action=update&root.Notifications=on&tag=Office
http://192.168.0.3:8083/param.cgi?action=update&root.Notifications=off
http://192.168.0.3:8083/param.cgi?action=update&root.Notifications=off&tag=Home

Power safe mode

Admin only. The root.PowerSafeMode parameter is used to switch on/off power safe mode in tinyCam Monitor.

 http://<servername>/param.cgi?action=update&root.PowerSafeMode=<string> 


Parameters:

 root.PowerSafeMode=<string>
Can be on or off. Mandatory.


Examples:

http://192.168.0.3:8083/param.cgi?action=update&root.PowerSafeMode=on
http://192.168.0.3:8083/param.cgi?action=update&root.PowerSafeMode=off

Delete file

Admin only. action=delete with root.Filename parameter used to delete recorded MP4 or JPEG files in tinyCam Monitor.

 http://<servername>/param.cgi?action=delete&root.Filename=<string> 


Parameters:

 root.Filename=<string>
Filename. Mandatory.


Examples:

http://192.168.0.3:8083/param.cgi?action=delete&root.Filename=/IPV68P2P/2016-10-21%2010.03.33.mp4

Pin file

Admin only. action=pin with root.Filename parameter used to pin recorded MP4 or JPEG files in tinyCam Monitor.

 http://<servername>/param.cgi?action=pin&root.Filename=<string> 


Parameters:

 root.Filename=<string>
Filename. Mandatory.


Examples:

http://192.168.0.3:8083/param.cgi?action=pin&root.Filename=/IPV68P2P/2016-10-21%2010.03.33.mp4

Unpin file

Admin only. action=unpin with root.Filename parameter used to unpin recorded MP4 or JPEG files in tinyCam Monitor.

 http://<servername>/param.cgi?action=unpin&root.Filename=<string> 


Parameters:

 root.Filename=<string>
Filename. Mandatory.


Examples:

http://192.168.0.3:8083/param.cgi?action=unpin&root.Filename=/IPV68P2P/2016-10-21%2010.03.33_pin.mp4

Reboot Android device

Admin only. Root required.

 http://<servername>/axis-cgi/admin/restart.cgi


Parameters:

None.


Examples:

http://192.168.0.3:8083/axis-cgi/admin/restart.cgi

Getting parameters in JSON

Admin only.

 http://<servername>/api/v1/get_cam_list


Parameters:

None.


Examples:

http://192.168.0.3:8083/api/v1/get_cam_list.json