JVC VN-V686UAPI manual Encoded User Name and Password

Page 16

GET

space

API Characters

space

 

HTTP/1.1

0x0D 0x0A

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Accept:

 

space

 

text/plain (or text/html)

 

0x0D 0x0A

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Host:

space

IP Address of VN-V686

0x0D 0x0A

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Authorization: Basic

 

space

Encoded User Name and Password

0x0D 0x0A 0x0D 0x0A

 

 

 

 

 

 

 

 

 

 

 

 

 

 

The following is an example of API for Getting subnet mask of VN-V686.

Example

GET /api/param?network.interface.subnetmask HTTP/1.1<CRLF>

Accept: text/plain<CRLF>

Host: 192.168.0.2<CRLF>

Authorization: Basic YWRtaW46dm4tdjY4Ng==<CRLF><CRLF>

Specify the response format by Accept line. Plain text response is returned when this is specified as text/plain. HTML response is returned when text/html is specified. HTML response is returned when Accept is not specified.

These APIs for getting/setting parameters are protected by basic authentication. Authorization line needs to include encoded username and password. There are 3 types of usernames, namely admin, operator and user. Available APIs are different for each username. Join the user name and the password using a colon, Base64 encode this character string and enter this in the Authorization line.

For example, when User name admin Password vn-v686

then the character string joining the user name and the password with a colon is: admin:vn-v686

Base64 encoding of this string yields YWRtaW46dm4tdjY4Ng==. Enter this in the Authorization line. Default password for each username is vn-v686.

3)VN-V686 returns a response to the client. In the following example, current subnet mask is 255.0.0.0. In addition, 255.0.0.0 is followed by & and 200 OK, indicating that getting parameter is successful.

Example

HTTP/1.1 200 OK<CRLF>

Connection: close<CRLF>

Content-Length: 80<CRLF>

Content-type: text/plain<CRLF>

16

Image 16
Contents VN-V686U Updates Custom Application Software Development Guide Content Basic Procedures Host 192.168.0.2CRLFCRLFPage API Format Structure Response When API is successfully received with boundary=onParameter Description Restrictions When API is successfully received with boundary=offJpeg File Format Sent Out by VN-V686 190.00 .00 corresponds to -5 degrees Getting MPEG-4 from VN-V686 via Http Page Response When API is successfully received MPEG-4 Stream Format Sent Out by VN-V686 Search VN-V686 in LAN VOL VOPGetting Alarm from VN-V686 ProcedureEncoded User Name and Password General Setting Camera ID in Jpeg from VN-V686 Camera Saving Changes of Camera SettingsGetting Camera ID stored in Jpeg from VN-V686 Setting Monitor Type for VN-V686 Setting Black level for VN-V686Getting Monitor Type from VN-V686 Getting Black level from VN-V686Setting Gamma for VN-V686 Setting Active Gamma Level for VN-V686Getting Gamma from VN-V686 Getting Active Gamma Level from VN-V686Setting Enhance Band for VN-V686 Setting Enhance for VN-V686Getting Enhance Band from VN-V686 Getting Enhance from VN-V686Setting Color Level for VN-V686 Setting Stabilizer for VN-V686Getting Color Level from VN-V686 Getting Stabilizer from VN-V686Setting Stabilizer Level for VN-V686 Setting DNR for VN-V686Getting Stabilizer Level from VN-V686 Getting DNR from VN-V686Setting AGC for VN-V686 Setting Limit of Sense Up for VN-V686Getting AGC from VN-V686 Getting Limit of Sense Up from VN-V686Setting ALC priority for VN-V686 Setting Shutter Speed for VN-V686Getting B&W Mode from VN-V686 Getting Shutter Speed from VN-V686Setting B&W Mode for VN-V686 Getting Auto Focus mode for B&W switching from VN-V686Setting Auto Focus mode for B&W switching for VN-V686 Getting Light setting for focus in B&W mode from VN-V686Saving Image Settings for Auto Pan and Auto Trace Setting Light for focus in B&W mode for VN-V686Getting Iris from VN-V686 Setting Iris for VN-V686 Setting Iris Direction for VN-V686Operating Iris for VN-V686 Getting White Balance from VN-V686Setting White Balance for VN-V686 Setting R-Gain of White Balance for VN-V686Getting R-Gain of White Balance from VN-V686 Getting B-Gain of White Balance from VN-V686Setting B-Gain of White Balance for VN-V686 Getting Current R-Gain of Auto White Balance from VN-V686Getting Current B-Gain of Auto White Balance from VN-V686 Getting Back Light Compensation from VN-V686Setting Back Light Compensation for VN-V686 Encoding Saving Changes of Encode Settings for VN-V686Setting Jpeg Frame Size for VN-V686 Getting Jpeg Frame Size from VN-V686Getting Jpeg Rate Control Setting from VN-V686 Setting Jpeg Rate Control for VN-V686Getting Jpeg File Size Setting from VN-V686 Setting Jpeg File Size Setting for VN-V686Setting MPEG-4 Frame Size for VN-V686 Getting MPEG-4 Frame Size from VN-V686Getting MPEG-4 bitrate Setting from VN-V686 Setting MPEG-4 bitrate Setting for VN-V686Getting MPEG-4 Rate Control Setting from VN-V686 Setting MPEG-4 Rate Control for VN-V686Setting MPEG-4 Frame Rate Setting for VN-V686 Getting MPEG-4 I-Frame Interval Setting from VN-V686Setting MPEG-4 I-Frame Interval Setting for VN-V686 Getting MPEG-4 Priority Setting from VN-V686Setting MPEG-4 Priority Setting for VN-V686 Alarm Setting Getting On/Off of Alarm Action from VN-V686Format /api/param?application.eventNumber.status Format /api/param?application.eventNumber.status=dataGetting Alarm Action from VN-V686 Format /api/param?application.eventNumber.actionApi/param?application.event1.action Example of Response application.event1.action=&200 OKFormat /api/param?application.eventNumber.action=Data Setting Alarm Action for VN-V686Ssage Alarm%20ON Setting Alarm Filter for VN-V686 Getting Alarm Filter Setting from VN-V686Api/param?application.event1.filtersunday.status=on Getting Alarm Filter Time from VN-V686 Setting Alarm Filter Time for VN-V686Getting Alarm Filter Type from VN-V686 Setting Alarm Filter Type for VN-V686Getting Alarm Trigger from VN-V686 Api/param?application.event1.filtersunday.type=unmaskSetting Alarm Trigger for VN-V686 Example of Response application.event1.trigger=v1&200 OKFormat /api/param?application.eventNumber.trigger=data Api/param?application.event1.trigger=m1Setting Example /api/param?application.event1.trigger=v1 Setting Smtp Server Address for VN-V686Setting Example /api/param?application.event6.trigger=i1500 Getting Smtp Server Port Number Setting from VN-V686 Setting Smtp Server Port Number for VN-V686Getting Sender Mail Address Setting from VN-V686 Setting Sender Mail Address for VN-V686Getting POP before Smtp Setting from VN-V686 Setting POP before Smtp for VN-V686Getting POP Server Address Setting from VN-V686 Setting POP Server Address for VN-V686Setting POP Server Port Number for VN-V686 Getting POP Server User Name Setting from VN-V686Setting POP Server User Name for VN-V686 Example of setting /api/param?application.pop.user=somenameSetting POP Server Password for VN-V686 Getting FTP Server Address Setting from VN-V686Setting FTP Server Address for VN-V686 Getting FTP Server Path Setting from VN-V686Getting FTP Server User Name Setting from VN-V686 Setting FTP Server User Name for VN-V686Setting FTP Server Password for VN-V686 Getting File Naming of Periodic FTP from VN-V686Example of Response application.ftp.naming=default&200 OK Setting File Naming of Periodic FTP for VN-V686Getting User Define Name of File Naming from VN-V686 Setting Parameters of Pre/Post Recording for VN-V686 Setting User Define Name of File Naming for VN-V686Getting Parameters of Pre/Post Recording from VN-V686 Getting Alarm Output Time Setting from VN-V686 Setting Alarm Output Time for VN-V686Getting Alarm Output Status from VN-V686 Changing Alarm Output of VN-V686Getting Auto Return Mode from VN-V686 Setting Auto Return Mode for VN-V686Getting Timeout of Auto Return from VN-V686 Setting Timeout of Auto Return for VN-V686Getting Auto Return Status from VN-V686 Setting Auto Return Status for VN-V686Start/Stop of Auto Tracking for VN-V686 Setting Detection Level of Auto Tracking for VN-V686 Specify target for Intelligent Tracking for VN-V686Getting Detection Level of Auto Tracking from VN-V686 Getting Restart Time of Auto Tracking from VN-V686Setting Restart Time of Auto Tracking for VN-V686 Setting Detection Area of Intelligent Tracking for VN-V686Getting Detection Area of Intelligent Tracking from VN-V686 Format /api/param?camera.motion.autotracking2.areaSetting Tracking Zoom of Intelligent Tracking for VN-V686 Setting Zoom Limit of Intelligent Tracking for VN-V686Getting Zoom Limit of Intelligent Tracking from VN-V686 Getting Maximum Zoom of Intelligent Tracking from VN-V686Setting Maximum Zoom of Intelligent Tracking for VN-V686 Setting Threshold of Intelligent Tracking for VN-V686Getting Threshold of Intelligent Tracking from VN-V686 Getting Dead Zone of Intelligent Tracking from VN-V686Setting Dead Zone of Intelligent Tracking for VN-V686 Setting Upper Limit of EZoom for VN-V686Setting On/Off of Pan Limit for VN-V686 Getting Upper Limit of EZoom from VN-V686Setting Left Side of Pan Limit for VN-V686 Setting Right Side of Pan Limit for VN-V686Getting Left Side of Pan Limit from VN-V686 Getting Right Side of Pan Limit from VN-V686Setting Tilt Limit for VN-V686 Getting Speed of Going to Preset Position from VN-V686Setting Speed of Going to Preset Position for VN-V686 Getting Auto Flip Setting from VN-V686Getting Current Status of Digital Flip from VN-V686 Setting Auto Flip for VN-V686Getting Pan Position from VN-V686 Setting Direction of Pan Operation for VN-V686 Setting Speed of Pan Operation for VN-V686Moving to Specified Pan Position for VN-V686 Pan Operation for VN-V686Setting Status of Variable Pan/Tilt Speed for VN-V686 Getting Tilt Position from VN-V686Moving to Specified Tilt Position for VN-V686 Tilt Operation for VN-V686Setting Direction of Tilt Operation for VN-V686 Setting Speed of Tilt Operation for VN-V686Getting Tilt Operation Status from VN-V686 Getting Zoom Position from VN-V686Setting Direction of Zoom Operation for VN-V686 Setting Speed of Zoom Operation for VN-V686Zoom Operation for VN-V686 Getting Zoom Operation Status from VN-V686Setting Direction of Focus Operation for VN-V686 Setting Speed of Focus Operation for VN-V686Moving to Specified Focus Position for VN-V686 Focus Operation for VN-V686Getting Current Preset Position from VN-V686 Getting Status of Specified Preset Position from VN-V686Register Current Position as Preset Position for VN-V686 Initialize Preset Position for VN-V686Moving to Preset Position for VN-V686 Getting Title of Preset Position from VN-V686Setting Title to Preset Position for VN-V686 Getting Status of Auto Pan from VN-V686Setting Direction of Auto Pan for VN-V686 Setting Speed of Auto Pan for VN-V686Getting Direction of Auto Pan from VN-V686 Getting Speed of Auto Pan from VN-V686Getting Status of Auto Trace from VN-V686 Start/Stop of Auto Trace for VN-V686Start/Stop of Auto Trace Recording for VN-V686 Api/param?camera.motion.autotrace.record.status=startAuto Patrol Start/Stop of Auto Patrol for VN-V686 Getting Status of Auto Trace Recording from VN-V686Getting Status of Auto Patrol from VN-V686 Getting Preset Postion Number of Auto Patrol from VN-V686 Setting Preset Postion Number of Auto Patrol for VN-V686Setting Duarion of Auto Patrol for VN-V686 Getting Duration of Auto Patrol from VN-V686Setting Whole Status of Privacy Masking for VN-V686 Getting Status of a Privacy Masking Area from VN-V686Setting Status of a Privacy Masking Area for VN-V686 Setting Privacy Masking Brightness for VN-V686Getting Privacy Masking Brightness from VN-V686 Start/Save Editing of Privacy Masking for VN-V686Setting Height of Privacy Masking Area for VN-V686 Setting Width of Privacy Masking Area for VN-V686Setting Motion Detect to On/Off for VN-V686 Setting Motion Detect Sensitivity for VN-V686 Setting Motion Detect Mask for VN-V686Getting Motion Detect Sensitivity from VN-V686 Getting Motion Detect Mask from VN-V686Getting Dhcp Setting from VN-V686 Network Basics Enabling Network Setting ChangesSetting Dhcp for VN-V686 Setting IP Address for VN-V686 Setting Subnet Mask for VN-V686Getting Default Gateway from VN-V686 Getting IP Address from VN-V686Setting Default Gateway for VN-V686 Setting Host Name for VN-V686Getting Host Name from VN-V686 Getting DNS Server On/Off Status from VN-V686Setting DNS Server IP Address for VN-V686 Getting DNS Server IP Address from VN-V686Getting MAC Address from VN-V686 Network Details Getting TOS Value of Jpeg from VN-V686Setting TOS Value of Jpeg for VN-V686 Setting TOS Value of MPEG-4 for VN-V686Setting Unicast TTL for VN-V686 Getting TOS Value of MPEG-4 from VN-V686Setting Multicast TTL for VN-V686 Setting MTU Value for VN-V686Getting Multicast TTL Value from VN-V686 Getting MTU Value VN-V686Getting Network Negotiation Setting from VN-V686 Setting Network Negotiation for VN-V686Setting Port Number of Http for VN-V686 Protocol Getting Port Number of Http from VN-V686Setting Jpeg Multicast Address for VN-V686 Getting Jpeg Multicast Address from VN-V686Setting Jpeg Multicast Port Number for VN-V686 Setting Frame Rate of Jpeg Multicast for VN-V686Getting Jpeg Multicast Port Number from VN-V686 Getting Frame Rate of Jpeg Multicast from VN-V686Getting MPEG-4 Multicast Address from VN-V686 Setting MPEG-4 Multicast Address for VN-V686Getting MPEG-4 Multicast Port Number from VN-V686 Setting Client Restriction to Deny/Allow for VN-V686 Setting MPEG-4 Multicast Port Number for VN-V686Format /api/param?network.accesscontrolstreamout.hostNumber Setting IP Address of Restricted Client for VN-V686 Network.accesscontrolstreamout.host1=10.0.0.0/24&200 OKExample /api/param?network.accesscontrolstreamout.host1=%00 Time Getting On/Off of Sntp Client from VN-V686Setting NTP Server Address for VN-V686 Getting Access Interval to NTP Server from VN-V686Setting Access Interval to NTP Server for VN-V686 Getting NTP Server Address from VN-V686Getting Access Interval Unit of NTP from VN-V686 Setting Access Interval Unit of Sntp for VN-V686Setting Time for VN-V686 Getting Time from VN-V686GMT-9 Password Setting Password for VN-V686 Setting Timezone for VN-V686Format /api/param?system.password.data1=data2 Maintenance Initialization Firmware UpdateGetting Status of Auto Cleaning from VN-V686 Setting Auto Cleaning for VN-V686Getting Status Getting Sending Status Setting Time of Auto Cleaning for VN-V686Format /api/param?system.session Getting Log Getting Settings Getting Model NameGetting Firmware Revisions of Streaming Manager Getting Alarm Input Status from VN-V686 Getting Firmware Revisions of PTZ ControllerGetting Firmware Revisions of Image Processor Getting Firmware Revisions of LensGetting Mode of FTP Server from VN-V686 Setting Mode of FTP Server for VN-V686Setting Control Port Number of FTP Server for VN-V686 Getting Control Port Number of FTP Server from VN-V686List of Protocols and Port Numbers Used with VN-V686 Methods of ActiveX Getting Multicast Seamless Switching 103 104 FAQ