Vivotek VS8102 User Manual page 99

Overview
For some customers who already have their own web site or web control application, a Network
Camera/Video server can be easily integrated through URLs. This document provides the supersets of URL
commands V2 for VIVOTEK 8000 series products.
This section specifies the external HTTP-based application programming interface. The HTTP-based camera
interface provides the functionality to request a single image, to control camera functions (PTZ, output
relay etc.), and to get and set internal parameter values. The image and CGI-requests are handled by the
built-in Web server.
Style Convention
In URL syntax and in descriptions of CGI parameters, a text within angle brackets denotes a content that is
to be replaced with either a value or a string. When replacing the text string, the angle brackets shall also
be replaced. An example of this is the description of the name for the server, denoted with <servername>
in the URL syntax description below, which is replaced with the string myserver in the URL syntax example,
also below.
URL syntax is written with the word "Syntax:" written in bold face followed by a box with the reference
syntax as seen below. The name of the server is written as <servername>. This is intended to be replaced
with the name of the actual server. This can either be a name, e.g., "mywebcam" or "thecam.adomain.net"
or the associated IP number for the server, e.g., 192.168.0.220.
Special notes will be marked in RED.
Syntax:
http://<servername>/cgi-bin/viewer/video.jpg
Description of returned data is written with "Return:" in bold face followed by the returned data shown in a
box. All data is returned as HTTP formatted, i.e., starting with the string HTTP and line separated with a
Carriage Return and Line Feed (CRLF) printed as \r\n.
Return:
HTTP/1.0 <HTTP code> <HTTP text>\r\n
URL syntax examples are written with "Example:" in bold face followed by a short description and a light
grey box with the example.
Example: Request a single snapshot image
http://mywebserver/cgi-bin/viewer/video.jpg
VIVOTEK
User's Manual - 99