9.2

Creating URL requests
You can use URL requests to make QuarkXPress Server render projects in a variety of
formats, to use the features of server XTensions modules, and to control the server. The
topics below provide an overview of how to construct server requests and use URL
parameters.
This chapter also lists functions that let you control the server. For detailed information
about constructing other types of URL requests, see the QuarkXPress Server Web Integration
Guide.
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:
30 | A GUIDE TO QUARKXPRESS SERVER 9.2
CREATING URL REQUESTS