VIVOTEK
User's Manual - 115
Appendix
URL Commands for the Network Camera
1. Overview
For some customers who already have their own web site or web control application, the Network
Camera/Video Server can be easily integrated through URL syntax� This section specifies the external
HTTP-based application programming interface� The HTTP-based camera interface provides the
functionality to request a single image, control camera functions (PTZ, output relay etc�), and get and set
internal parameter values� The image and CGI-requests are handled by the built-in Web server�
2. Style Convention
In URL syntax and in descriptions of CGI parameters, text within angle brackets denotes content that
is to be replaced with either a value or a string� When replacing the text string, the angle brackets
should 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, that is replaced with the string myserver in the URL
syntax example further down in the page�
URL syntax is denoted with the word "Syntax:" written in bold face followed by a box with the referenced
syntax as shown below. For example, name of the server is written as <servername> and 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�
Syntax:
http://<servername>/cgi-bin/viewer/video.jpg
Description of returned data is written with "Return:" in bold face followed by the returned data in a box� All data is
returned in HTTP format, i.e., each line is 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