print (POST)

{server}/api/v1/printPdf/print

Description

Print PDF document content with given PDF printing and device settings.

See also the OpenAPI (Swagger) definition.

Applies to:

  • ScriptX.Services for Cloud
  • ScriptX.Services for On-Premise Devices (Authorisation header is ignored)
  • ScriptX.Services for Windows PC

Request parameters

PrintPdfDescription:
document (string, required)
The URI to the PDF document to print.
description (string, optional)
Optional string that can be used for tracking jobs.
device (DevicePrintSettings, optional)
Settings for printer/device as described in the DevicePrintSettings class.
settings (PdfPrintSettings, optional)
Settings for print job content as described in the PdfPrintSettings class.
DevicePrintSettings:
printerName (string, optional)
Name of the printer/device on the server to be used for the print job.
paperSizeName (string, optional)
Name of paper size to use for the print job.
paperSourceName (string, optional)
Name of paper source (or bin) to use for the print job (eg. 'Upper tray').
collate (integer, optional)
Collation for the print job. Value can be 0 (Default), 1 (True) or 2 (False).
copies (integer, optional)
Number of copies to be printed.
duplex (integer, optional)
Type of duplex to be used for the print job. Value can be 0 (Default), 1 (Simplex ie. not Duplex), 2 (Vertical duplex) or 3 (Horizontal duplex).
PdfPrintSettings:
pageRange (string, optional)
String that determines which pages of the printed output to print eg. "1,3,5-8" will print pages 1, 3, 5, 6, 7 and 8.
pageScaling (integer, optional)
Option to scale pages. Value can be 0 (No scaling), 1 (Fit to paper), 2 (Shrink large pages) or -1 (Undefined).
autoRotateCenter (integer, optional)
Indicates whether pages should be rotated to fit on the paper and centered. If this parameter is not given it will be set to 1 (True) if pageScaling is 1. Value can be 0 (Default), 1 (True) or 2 (False).
orientation (integer, optional)
Setting for page orientation. Value can be 0 (Default), 1 (Landscape) or 2 (Portrait).
normalise (boolean, optional)
Indicates whether or not the pages should be processed to ensure drawing operations are at the expected positions. This option may assist if documents do not print as required.
printQuality (integer, optional)
Option to request the print quality to be used. Value can be 0 (Normal), 1 (High) or 2 (Lossless).

Response model

Print:
status (integer, optional)
Code indicating initial status of submitted job. 1 (Queued to device), 2 (Queued to file), 3 (Soft error), 4 (Ok)
jobIdentifier (string, optional)
Returns the job token which can then be used in status calls to monitor job progress and (if printing to a PDF file) download to download the output file.
message
Returns error message if status is 3, otherwise returns empty string.

Example usage