Introduction

The "v3" viewing package REST APIs allow you to manage and use documents that have been pre-converted and cached for viewing.

NOTE: These APIs are not for use with the PrizmDoc Viewer Client. If you need to pre-convert a document for the PrizmDoc Viewer client, use the PAS "v2" viewing package creators and viewing packages REST APIs instead (see Work with Viewing Packages in the PAS Developer Guide for more information).

NOTE: The "v3" viewing packages and viewing package creators REST APIs are currently only available for on-premise deployments.

NOTE: This feature is disabled by default. See Enable Pre-Conversion to PDF on how to enable and configure this feature.

Available URLs

The URLs described on this page allow you to get information about an already-created viewing package and download its associated PDF. If you need to create a new viewing package, see the viewing package creators REST API.

GET /v3/viewingPackages/{packageId}

Gets information about an already-created viewing package (to create a new viewing package, see viewing package creators).

Request

URL Parameters

Response body

JSON object with the following properties:

• expirationDateTime (String) Only present when lifetimeAfterLastUse is not "forever". Specifies the date and time (in ISO 8601 Extended Format) when the viewing package is currently scheduled to be deleted. Each time the package is used, this value will be extended into the future so that it points to current time plus the amount specified by lifetimeAfterLastUse.
• creationDateTime (String) Date and time (in ISO 8601 Extended Format) when the viewing package was created.
• bytes (Integer) Size of the viewing package in bytes.
• lifetimeAfterLastUse (String) Amount of time a viewing package will be kept after its most recent use, after which it will be automatically deleted. Value will be one of the following:
  • A string indicating a number of days, such as "30d" for 30 days
  • "forever" if the package is set to be kept indefinitely

Error Responses and JSON Error Codes

Example

Request

GET /v3/viewingPackages/U3BlY2lhbCBPcmRlciAjOTM3

Response

HTTP 200 OK
Content-Type: application/json

{
  "expirationDateTime": "2122-07-03T00:00:00.000Z",
  "creationDateTime": "2101-01-01T0:00:00.000Z",
  "bytes": 180924609,
  "lifetimeAfterLastUse": "30d"
}

GET /v3/viewingPackages/{packageId}/content/pdf

Gets the PDF contained in the viewing package (a PDF representation of the original document used to create the viewing package).

Issuing this request will count as a use of the viewing package. If lifetimeAfterLastUse is not "forever", the package's expirationDateTime will be increased to the current time plus lifetimeAfterLastUse.

Request

URL Parameters

Response body

PDF file bytes.

Error Responses and JSON Error Codes

Example

Request

GET /v3/viewingPackages/U3BlY2lhbCBPcmRlciAjOTM3/content/pdf

Response

HTTP 200 OK
Content-Type: application/pdf

<PDF file bytes>