10.2.1

Table Of Contents
Understanding URL requests
QuarkXPress Server URL requests should use the following format:
http://server:port/namespace/path/projectname?parameter=value
server: Indicates the name or IP address of the QuarkXPress Server computer.
port: Indicates the QuarkXPress Server application's port number. The default port
number is 8080.
namespace: Sets the render type (or indicates another server functionality to access).
For more information, see "Understanding QuarkXPress Server namespaces"
path: Indicates the path to the directory where the target project file is stored. The
project to be rendered can either be located in the document pool (in which case paths
are evaluated relative to the document pool directory), or can be streamed as part of
a multipart HTTP Post request. When the project is streamed as part of the request,
the project name will correspond to the name given to the HTTP request part which
contains the project data.
projectname: Identifies the project to be rendered.
parameter=value: Optional parameters that provide more detailed control over how
the target project should be rendered. Multiple parameter/value pairs, separated by
the "&" character, can be included.
For example, the following URL asks the QuarkXPress Server application named
"QXPServer" to return the file "MyProject.qxp" as a PDF file with hyperlinks and all
fonts embedded:
http://QXPServer:8080/pdf/MyProject.qxp?includehyperlinks=1&embedallfonts=1
Some URL parameters require Boolean arguments. For such parameters, valid values
include 1 or 0, true or false, y or n, and yes or no.
You can also send requests to QuarkXPress Server using the HTTP GET and POST
protocols and using XML with XSLT. For more information about these approaches,
see "Using QuarkXPress Server."
Understanding QuarkXPress Server namespaces
QuarkXPress Server namespaces differentiate among types of requests that are otherwise
identical. For example, consider the following three URLs:
http://QXPServer:8080/project1.qxp
http://QXPServer:8080/pdf/project1.qxp
http://QXPServer:8080/postscript/project1.qxp
These requests are identical, except each uses a different namespace (in italic). (The
first request does not specify a namespace, but this simply means the project is to be
rendered using the server's default render type.)
Namespaces can be used to determine the format in which a rendered project is
returned, as indicated above, but they can also be used to direct a request to XTensions
software that performs other functions. For example, if you use Modifier XTensions
34 | A GUIDE TO QUARKXPRESS SERVER 10.2.1
USING QUARKXPRESS SERVER