Web service API

How to use PageSeeder's Web service API

uri export

/members/{member}/uris/{uri}/export [GET]

com.pageseeder.export.Export

Description

Export a document (URI) and any of its referenced documents.

This service exports the document(s) specified using the Universal Portable Format.

Note

It is also the service supporting the export Ant task. If you're working with Ant or outside a Web environment, it may be more appropriate to use the Ant task.

If there are more than 20 documents included in the export this service will start an Asynchronous process.

Parameters

NameDescriptionRequiredTypeDefault value
compare Value of the release to compare with, if the value is a float and none match, the closest previous release is loaded no string
context Context path without the site prefix no path URI folder
excludes A comma-separated list of file name patterns to exclude from the export, only used if "path" is specified and points to a folder no strings
fail-on-error Flag to specify if the first error should kill the export no boolean false
forward-depth The depth of outgoing cross-references to traverse no integer  0 
includes A comma-separated list of file name patterns to include in the export, only used if "path" is specified and points to a folder no strings
load-alternates Flag to specify if referenced files with XRef type="alternate" should be included in the export no boolean true
load-images Flag to specify if referenced images should be included in the export no boolean true
metadata-only Flag to specify if only metadata PSML should be included in the export no boolean false
release Value of the version to export, if the value is a float and none match, the closest previous release is loaded no string
resolve-images Flag to specify if referenced images should be included in the export. DEPRECATED use load-images instead. no boolean true
reverse-depth The depth of inward cross-references to traverse no integer 0
since Last modified date used to filter URIs to export, only used if "path" is specified and points to a folder no date or datetime
with Comma-separated list of facets used to filter URIs to export, only used if "path" is specified and points to a folder no strings
xref-types A comma-separated list of cross-references to traverse no  strings (all types)

Permission

Undocumented permissions requirements.

Response

This service returns the following XML:

<thread ...>
  ...
  [<processing current="[number processed]" total="[total processing]"/>]
  [<packaging current="[number packaged]" total="[total packaging]"/>]
  [<zip>[zip file name]</zip>]
</thread>

When the export is complete it can be downloaded using the URL:

[scheme]://[my server]/ps/member-resource/[group name]/[zip file name]

For example:

https://example.org/ps/member-resource/example-specs/export-1449617820208.zip

Error handling

No specific errors expected for this service.

Created on , last edited on