2016

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 2016
USING QUARKXPRESS SERVER