9.5

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.)
34 | A GUIDE TO QUARKXPRESS SERVER 9.5
USING QUARKXPRESS SERVER