openapi: 3.0.0 info: title: PDFreactor Web Service Conversion REST API description: This is the conversion REST API definition and documentation of the PDFreactor Web Service. termsOfService: https://www.pdfreactor.com contact: name: PDFreactor Support Team email: support@realobjects.com url: http://www.pdfreactor.com license: name: PDFreactor Software License Agreement url: https://www.pdfreactor.com x-logo: url: https://www.realobjects.com/wp-content/uploads/images/logos/prlogo-180x180.png altText: PDFreactor Logo version: 12.0.2 servers: - url: http://localhost:9423/service/rest - url: https://cloud.pdfreactor.com/service/rest paths: /convert: post: description: > Converts the specified configuration or asset package into PDF or image and returns the generated PDF or image. summary: Convert synchronously requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Configuration' application/xml: schema: $ref: '#/components/schemas/Configuration' application/zip: schema: type: string format: binary responses: '200': description: Conversion successful content: &responseResult application/json: schema: $ref: '#/components/schemas/Result' application/xml: schema: $ref: '#/components/schemas/Result' application/pdf: schema: type: string format: binary application/octet-stream: schema: type: string format: binary text/plain: schema: type: string format: base64 '400': &response400 description: > Multiple Reasons: (1) No configuration was supplied to the operation. (2) No input document was specified in the configuration. (3) The page number you specified is either below 0 or exceeds the document's total number of pages. (4) The supplied configuration was not valid for some reason. See the error message for details. (5) The version of the client that was used is outdated and no longer supported. This is only available for the PDFreactor REST clients. content: &responseResultError application/json: schema: $ref: '#/components/schemas/Result' application/xml: schema: $ref: '#/components/schemas/Result' '*/*': schema: type: string '401': &response401 description: &response401desc > The client failed an authorization check, e.g. because a supplied API key was invalid. content: *responseResultError '422': &response422 description: &response422desc > The supplied configuration was accepted by PDFreactor but could not be converted for some reason. See the error message for details. content: *responseResultError '500': &response500 description: &response500desc > Multiple Reasons: (1) The configuration could not be processed and should be re-checked. (2) The supplied configuration is valid, however the conversion could not be completed for some reason. See the error message for details. content: *responseResultError '503': &response503 description: &response503desc > Multiple Reasons: (1) Asynchronous conversions are not available in this PDFreactor Web Service. (2) The PDFreactor Web Service is running and reachable, but not in a state to perform the requested operation. content: *responseResultError /convert/async: post: description: > Converts the specified configuration or asset package into PDF or image. This operation responds immediately and does not wait for the conversion to finish. This is especially useful for very large or complex documents where the conversion will take some time. summary: Convert asynchronously requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Configuration' application/xml: schema: $ref: '#/components/schemas/Configuration' application/zip: schema: type: string format: binary responses: '202': description: Conversion successfully started headers: Location: description: The relative URL where the progress of the conversion can be polled. schema: type: string format: url example: "/progress/{documentId}" '400': *response400 '401': *response401 '422': *response422 '500': *response500 '503': description: > Multiple Reasons: (1) Asynchronous conversions are not available in this PDFreactor Web Service. (2) The PDFreactor Web Service is running and reachable, but not in a state to perform the requested operation. content: *responseResultError /progress/{id}: get: description: > Retrieves progress information about the asynchronous conversion with the given ID. summary: Retrieve progress for async conversion parameters: - &documentIdParam in: path name: id schema: type: string required: true description: The ID of the document. responses: '200': description: The current estimated progress, including log output. content: application/json: schema: $ref: '#/components/schemas/Progress' application/xml: schema: $ref: '#/components/schemas/Progress' '201': description: The conversion is finished and the result can be accessed via the URL indicated in the 'Location' header. headers: Location: description: The location where the document can be downloaded. schema: type: string format: url example: "/document/{documentId}" '401': *response401 '404': &response404 description: &response404desc > Multiple Reasons: (1) A web service resource was not found. (2) Conversion does not exist. content: *responseResultError '500': *response500 '503': *response503 /document/{id}: get: description: > Retrieves the asynchronously converted document with the given ID. summary: Retrieve converted document parameters: - *documentIdParam - &deleteParam in: query name: delete schema: type: boolean required: false description: > Whether to delete the document after it was retrieved, regardless of the "keepDocument" configuration property. responses: '200': description: The document was found and the conversion has finished. content: *responseResult '400': *response400 '401': *response401 '404': *response404 '422': *response422 '500': *response500 '503': *response503 delete: description: > Deletes the asynchronously converted document with the given ID. If the conversion is still running, it gets terminated. summary: Delete converted document or terminate its conversion parameters: - *documentIdParam responses: '204': description: A message indicating that the document has been successfully deleted. '401': *response401 '404': *response404 '500': *response500 '503': *response503 /document/metadata/{id}: get: description: > Retrieves the metadata of the asynchronously converted document with the given ID. summary: Retrieve metadata of converted document parameters: - *documentIdParam responses: '200': description: The document's metadata only, meaning the properties 'document' and 'documentArray' will me missing. content: application/json: schema: $ref: '#/components/schemas/Result' application/xml: schema: $ref: '#/components/schemas/Result' '401': *response401 '404': *response404 '500': *response500 '503': *response503 /document/{id}/{page}: get: description: > Retrieves the specified page of the asynchronously converted multi-page image with the specified ID. This operation only functions when converting into image types, not PDF. Additionally, the configuration option "multiPage" has to be set to "true", otherwise there are no multiple pages. summary: Retrieve page of converted multi-page image parameters: - *documentIdParam - &pageParam in: path name: page schema: type: integer minimum: 1 required: true description: The page number. - *deleteParam responses: '200': description: A page of the converted document. content: &responseImage image/bmp: schema: type: string format: binary image/gif: schema: type: string format: binary image/jpeg: schema: type: string format: binary image/png: schema: type: string format: binary image/tiff: schema: type: string format: binary '401': *response401 '404': *response404 '500': *response500 '503': *response503 /document/{id}/show/{filename}: get: description: > Displays the asynchronously converted document in the browser. When downloading the document, browsers will save it under the specified filename. summary: Display converted document in browser parameters: - *documentIdParam - &filenameParam in: path name: filename schema: type: string required: true description: The desired file name including the file extension. - *deleteParam responses: '200': description: The converted document. content: &responseFile application/pdf: schema: type: string format: binary image/bmp: schema: type: string format: binary image/gif: schema: type: string format: binary image/jpeg: schema: type: string format: binary image/png: schema: type: string format: binary image/tiff: schema: type: string format: binary text/plain: schema: type: string format: base64 '401': *response401 '404': *response404 '500': *response500 '503': *response503 /document/{id}/{page}/show/{filename}: get: description: > Displays the specified page of the asynchronously converted multi-page image in the browser. When downloading the document, browsers will save it under the specified filename. summary: Display page of multi-page image in browser parameters: - *documentIdParam - *pageParam - *filenameParam - *deleteParam responses: '200': description: The converted document. content: *responseFile '401': *response401 '404': *response404 '500': *response500 '503': *response503 /document/{id}/download/{filename}: get: description: > Downloads the asynchronously converted document in the browser. The download is triggered by an appropriate "Content-Disposition" header. When downloading the document, browsers will save it under the specified filename. summary: Download converted document in browser parameters: - *documentIdParam - *filenameParam - *deleteParam responses: '200': description: The converted document. content: *responseFile '401': *response401 '404': *response404 '500': *response500 '503': *response503 /document/{id}/{page}/download/{filename}: get: description: > Downloads the specified page of the asynchronously converted multi-page image in the browser. The download is triggered by an appropriate "Content-Disposition" header. When downloading the document, browsers will save it under the specified filename. summary: Download page of multi-page image in browser parameters: - *documentIdParam - *pageParam - *filenameParam - *deleteParam responses: '200': description: The converted document. content: *responseImage headers: Content-Disposition: description: A header to trigger a download in the browser. schema: type: string '401': *response401 '404': *response404 '500': *response500 '503': *response503 /document/bundle: post: description: > Retrieves the asynchonously converted documents as a ZIP. summary: Retrieve converted documents as ZIP parameters: - *deleteParam requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Bundle' application/xml: schema: $ref: '#/components/schemas/Bundle' responses: '200': description: The converted documents as ZIP content: application/zip: schema: type: string format: binary application/octet-stream: schema: type: string format: binary '401': description: *response401desc content: &responseResultErrorZip '*/*': schema: type: string '404': description: *response404desc content: *responseResultErrorZip '422': description: > The supplied input data was accepted by PDFreactur but could not be processed for some reason. See the error message for details. content: *responseResultErrorZip '500': description: *response500desc content: *responseResultErrorZip '503': description: *response503desc content: *responseResultErrorZip /version: get: description: > Returns the version of the PDFreactor Web Service that is currently running. summary: Version of the PDFreactor Web Service responses: '200': description: The version. content: application/json: schema: $ref: '#/components/schemas/Version' application/xml: schema: $ref: '#/components/schemas/Version' text/plain: schema: type: string '401': &response401plain description: *response401desc content: text/plain: schema: type: string '503': description: *response503desc content: text/plain: schema: type: string /status: get: description: > Checks if the PDFreactor Web Service is available and functional. summary: Healthcheck responses: '200': description: The service is available and functional. content: text/plain: schema: type: string '401': *response401plain '503': description: The service is not functional. content: text/plain: schema: type: string /schema: get: description: > Retrieves the JSON schema for all data models consumed or produced by the PDFreactor Web Service. summary: JSON schema responses: '200': description: The JSON schema for all data models consumed or produced by the PDFreactor Web Service. content: text/plain: schema: type: string '401': *response401plain '404': description: The schema resource was not found. content: text/plain: schema: type: string /schema/{model}: get: description: > Retrieves the JSON schema for a specific data model consumed or produced by the PDFreactor Web Service. summary: JSON schema for model parameters: - in: path name: model schema: type: string required: true description: The model. responses: '200': description: The JSON schema a specific data model consumed or produced by the PDFreactor Web Service. content: text/plain: schema: type: string '400': description: The schema could not be created for the given model. content: text/plain: schema: type: string '401': *response401plain '404': description: The schema resource was not found. content: text/plain: schema: type: string components: schemas: AddressType: enum: - "LINK_LOCAL" - "LOCAL" - "PRIVATE" - "PUBLIC" type: "string" Attachment: additionalProperties: false properties: data: description: "

The binary content of the attachment. May be null.

" format: "base64" type: "string" description: description: "

The description of the attachment. If this is not set or\ \ null the value of name\ \ is used.

" type: "string" name: description: "

The file name associated with the attachment. It is recommended\ \ to specify the correct file extension. If this is not set or null the name is derived from url.

" type: "string" url: description: "

If data is not set or set to null,\ \ the attachment will be retrieved from this URL.

If this is \"\ #\" the input document URL is used instead.

" format: "url" type: "string" BookletMode: additionalProperties: false properties: rtl: description: "

Whether or not the reading order of the booklet should\ \ be right-to-left.

" type: "boolean" sheetMargin: description: "

The sheet margin as CSS margin value, for example \"\ 1in\", \"1cm 1.5cm\" or \"10mm 20mm 10mm 30mm\"\ . null is interpreted as\ \ \"1cm\".

" type: "string" sheetSize: description: "

The size of the sheet as CSS value, for example \"\ A3\", \"letter landscape\", \"15in 20in\"\ \ or \"20cm 30cm\". null\ \ is interpreted as \"A4 landscape\".

" type: "string" spacing: description: "

The horizontal and vertical space between pages on a sheet\ \ as CSS value, for example \"0.1in\". null\ \ is interpreted as \"1mm\".

" type: "string" Bundle: additionalProperties: false properties: documents: description: "An array of documents requests." items: $ref: "#/components/schemas/Document" type: "array" Callback: additionalProperties: false properties: contentType: $ref: "#/components/schemas/ContentType" description: "

The content type of the payload that is posted.

" interval: description: "

The interval in seconds at which to trigger repeating callbacks.

\ \

Only applies to \"PROGRESS\".

" type: "integer" timeout: description: "

An optional timeout for the callback in milliseconds. A\ \ value of zero or negative values are treated as an infinite timeout.

" type: "integer" type: $ref: "#/components/schemas/CallbackType" description: "

The event to trigger the callback.

" url: description: "

The URL to call back.

" format: "url" type: "string" CallbackType: enum: - "FINISH" - "PROGRESS" - "START" type: "string" Cleanup: enum: - "CYBERNEKO" - "JTIDY" - "NONE" - "TAGSOUP" type: "string" ColorSpace: enum: - "CMYK" - "RGB" type: "string" ColorSpaceSettings: additionalProperties: false properties: cmykIccProfile: $ref: "#/components/schemas/Resource" description: "

Specifies the ICC profile which defines the CMYK color\ \ space into or from which CSS colors and images are converted, if conversionEnabled.

" conversionEnabled: description: "

Enables the conversion of CSS colors and images to the\ \ targetColorSpace using the cmykIccProfile\ \ or naively if there is none.

" type: "boolean" targetColorSpace: $ref: "#/components/schemas/ColorSpace" description: "

Specifies the target color-space of the PDF, i.e. the color\ \ space that CSS keyword based colors are converted to.

When conversionEnabled\ \ is true other CSS colors\ \ and images are converted as well.

It is also the color space\ \ for PDF/A and PDF/X documents.

Defaults to \"RGB\".

" Configuration: additionalProperties: false properties: addAttachments: description: "

Enables or disables attachments specified in style sheets.

\ \

The default value is false.

" type: "boolean" addBookmarks: deprecated: true description: "

Deprecated as of PDFreactor 11. Use disableBookmarks\ \ instead.

" type: "boolean" addComments: description: "

Enables or disables comments in the PDF document.

The\ \ default value is false.

" type: "boolean" addLinks: deprecated: true description: "

Deprecated as of PDFreactor 11. Use disableLinks\ \ instead.

" type: "boolean" addOverprint: description: "

Enables or disables overprinting.

The default value\ \ is false.

" type: "boolean" addPreviewImages: description: "

Enables or disables embedding of image previews per page\ \ in the PDF document.

The default value is false.

" type: "boolean" addTags: description: "

Enables or disables tagging of the PDF document.

The\ \ default value is false.

" type: "boolean" allowAnnotations: deprecated: true description: "

Deprecated as of PDFreactor 12. Use allowAnnotations\ \ instead.

" type: "boolean" allowAssembly: deprecated: true description: "

Deprecated as of PDFreactor 12. Use allowAssembly\ \ instead.

" type: "boolean" allowCopy: deprecated: true description: "

Deprecated as of PDFreactor 12. Use allowCopy\ \ instead.

" type: "boolean" allowDegradedPrinting: deprecated: true description: "

Deprecated as of PDFreactor 12. Use allowDegradedPrinting\ \ instead.

" type: "boolean" allowFillIn: deprecated: true description: "

Deprecated as of PDFreactor 12. Use allowFillIn\ \ instead.

" type: "boolean" allowModifyContents: deprecated: true description: "

Deprecated as of PDFreactor 12. Use allowModifyContents\ \ instead.

" type: "boolean" allowPrinting: deprecated: true description: "

Deprecated as of PDFreactor 12. Use allowPrinting\ \ instead.

" type: "boolean" allowScreenReaders: deprecated: true description: "

Deprecated as of PDFreactor 12. Use allowScreenReaders\ \ instead.

" type: "boolean" appendLog: description: "

Specifies whether or not the log data should be added to\ \ the PDF document.

The default value is false.

" type: "boolean" attachments: description: "

Adds a file attachment to PDF document.

" items: $ref: "#/components/schemas/Attachment" type: "array" authenticationCredentials: $ref: "#/components/schemas/KeyValuePair" deprecated: true description: "

Deprecated as of PDFreactor 12. Use authenticationCredentials\ \ instead.

" author: description: "

Sets the value of the author field of the PDF document.

" type: "string" baseURL: deprecated: true description: "

Deprecated as of PDFreactor 11. Use baseUrl\ \ instead.

" type: "string" baseUrl: description: "

Sets the base URL of the document.

To resolve relative\ \ URLs to absolute URLs a reference (base) URL is required. This reference\ \ URL is usually the system id of the document.

This method can\ \ be used to specify another reference URL. If this URL is not null then it will be used instead of the\ \ system id.

The default value is null.

" type: "string" bookletMode: $ref: "#/components/schemas/BookletMode" description: "

Convenience method to set pages-per-sheet properties and\ \ page order in one step to create a booklet.

" callbacks: description: "

Adds callbacks to the conversion which will be called at\ \ specific times. All callbacks perform a POST request to the specified\ \ URL with the specified content type and a certain model which depends\ \ on the callback event.

For each callback, you can specify a timeout.\ \ If no timeout is specified, the server's default timeout for callbacks\ \ is used. A value of zero or negative values indicate an infinite timeout,\ \ however the PDFreactor server may have a maximum timeout configured,\ \ in which case that will be the used value.

Some callbacks might\ \ be called regularly during the course of a conversion. For these callbacks\ \ you can specify an interval to control how frequently they are called.

" items: $ref: "#/components/schemas/Callback" type: "array" cleanupTool: $ref: "#/components/schemas/Cleanup" description: "

Sets the cleanup tool to use for documents with unparsable\ \ content.

The Cleanup constants can be used as value.\ \ The default value specified is \"CYBERNEKO\".

The\ \ cleanup tool is only used for documentType \"XHTML\"\ . HTML5 utilizes an internal cleanup.

" colorSpaceSettings: $ref: "#/components/schemas/ColorSpaceSettings" description: "

Specifies color space related settings.

" conformance: $ref: "#/components/schemas/Conformance" description: "

Sets the conformance of the PDF.

The Conformance\ \ constants can be used as value. The default value specified is \"\ PDF\".

" contentObserver: $ref: "#/components/schemas/ContentObserver" description: "

Specifies parts of the document's content that should be\ \ observed and logged in greater detail. Data logged this way can be programmatically\ \ retrieved after the conversion has finished. The following can be observed:

\ \ " continuousOutput: $ref: "#/components/schemas/ContinuousOutput" description: "

Enables the conversion of the input document into one image.

" conversionName: description: "

Sets a name for the conversion. If a name is set, it will\ \ be logged at level \"info\". The name can be an arbitrary string but\ \ should be unique for every conversion or application so that the log\ \ output can be matched to a specific conversion or application later.

" type: "string" conversionTimeout: description: "

Sets a timeout in seconds for the whole document conversion.\ \ If the timeout is exceeded, the conversion will be aborted.

A\ \ timeout of 0 or negative values mean that the conversion will never\ \ time out. This is also the default behavior if no timeout is specified.

" type: "integer" cookies: deprecated: true description: "

Deprecated as of PDFreactor 12. Use cookies\ \ instead.

" items: $ref: "#/components/schemas/KeyValuePair" type: "array" creator: description: "

Sets the value of creator field of the PDF document.

" type: "string" cssSettings: $ref: "#/components/schemas/CssSettings" description: "

Specifies the behavior of PDFreactor regarding the support\ \ and validation of CSS properties and their declaration. The following\ \ modes can be set:

" customDocumentProperties: description: "

Adds a custom property to the PDF document. An existing\ \ property of the same name will be replaced.

" items: $ref: "#/components/schemas/KeyValuePair" type: "array" debugSettings: $ref: "#/components/schemas/DebugSettings" description: "

Enables and configures debug settings, which add additional\ \ information to the output.

If enabled, exceptions during the\ \ conversion will not be thrown. In such a case, instead of a document\ \ a string containing the log and exception will be returned.

" disableBookmarks: description: "

Disables bookmarks in the PDF document.

The default\ \ value is false.

" type: "boolean" disableFontEmbedding: description: "

Sets whether fonts will not be embedded into the resulting\ \ PDF. Setting this to true will reduce the file size of the output document.\ \ However, the resulting PDF documents are no longer guaranteed to look\ \ identical on all systems.

The default value is false.

" type: "boolean" disableLinks: description: "

Disables links in the PDF document.

The default\ \ value is false.

" type: "boolean" disablePdfStructureOptimization: description: "

Disables the automatic optimization and compression of\ \ the PDF structure.

The default value is false.

" type: "boolean" document: anyOf: - format: "xml" type: "string" - format: "html" type: "string" - format: "url" type: "string" description: "

The input document. This can either be a URL string, XML\ \ or HTML source code string.

" documentDefaultLanguage: description: "

Sets the language used for documents having no explicit\ \ language attribute set.

The language code is used to resolve\ \ the lang() selector correct and to determine the correct language used\ \ for hyphenation.

" type: "string" documentType: $ref: "#/components/schemas/Doctype" description: "

Sets the document type.

The Doctype constants\ \ can be used to specify the document type. The default value specified\ \ is \"AUTODETECT\".

" encoding: description: "

Sets the encoding of the document.

If this value\ \ is set to null or it is empty\ \ then the encoding will be detected automatically.

The default\ \ value is null.

" type: "string" encryption: $ref: "#/components/schemas/Encryption" deprecated: true description: "

Deprecated as of PDFreactor 12. Use encryptionSettings\ \ instead.

" encryptionSettings: $ref: "#/components/schemas/EncryptionSettings" description: "

Configures the PDF encryption settings. Specify an owner\ \ password and user password to allow or restrict access to certain PDF\ \ features such as copying or modifying.

" errorPolicies: description: "

Specifies error policies that will be used for the conversion.\ \ Depending on the policy, the conversion will fail if the appropriate\ \ criteria are not met.

" items: $ref: "#/components/schemas/ErrorPolicy" type: "array" fontAliases: description: "

Registers an alias font family for an existing font.

\ \

This function is limited to fonts loaded automatically from system\ \ folders.

" items: $ref: "#/components/schemas/Font" type: "array" fontFallback: description: "

Sets a list of fallback font families to be tried when\ \ none of the fonts listed using the CSS property font-family\ \ can be found. It is also used in cases of per character font fallback,\ \ when none of the specified fonts contain the required character.

" items: type: "string" type: "array" fonts: description: "

Loads a font from a URL which can be used via the CSS property\ \ font-family.

" items: $ref: "#/components/schemas/Font" type: "array" forceGrayscaleImage: description: "

If the output format is an image format, this setting controls\ \ whether a grayscale image should be returned. This can not be combined\ \ with transparency.

" type: "boolean" fullCompression: deprecated: true description: "

Deprecated as of PDFreactor 12. Use disablePdfStructureOptimization\ \ instead.

" type: "boolean" httpsMode: $ref: "#/components/schemas/HttpsMode" deprecated: true description: "

Deprecated as of PDFreactor 12. Use trustAllConnectionCertificates\ \ instead.

" ignoreAlpha: description: "

Sets whether the alpha value of CSS RGBA colors is ignored.\ \ This can be used to avoid conformance issues in PDF/A-1.

" type: "boolean" inspectableSettings: $ref: "#/components/schemas/InspectableSettings" description: "

When enabled, makes the converted document inspectable\ \ with the PDFreactor Development Tools.

Only works with \"\ PDF\" output and requires a license key.

" integrationStyleSheets: description: "

Adds an integration style sheet to the document.

There\ \ are two ways to specify the style sheet:

  1. Specifying the\ \ style sheet only using an URI.
  2. Specifying the style sheet by\ \ the content of the style sheet and alternatively setting a URI to resolve\ \ relative elements. If no URI is specified then the system id/base URL\ \ of the document will be used.
" items: $ref: "#/components/schemas/Resource" type: "array" javaScriptSettings: $ref: "#/components/schemas/JavaScriptSettings" description: "

Specifies JavaScript related settings.

" keepDocument: description: "

If set to true\ \ prevents the document from being deleted from the PDFreactor Web Service\ \ after it has been accessed. This only works for asynchronous conversions.

" type: "boolean" keywords: description: "

Sets the value of the keywords field of the PDF document.

" type: "string" licenseKey: description: "

Sets the license key either as content or URL. If the license\ \ key is set to null then PDFreactor\ \ looks for a license key file file in the same directory where the 'pdfreactor.jar'\ \ file is located. If no license key could be found then PDFreactor runs\ \ in evaluation mode.

The default value is null.

" type: "string" logLevel: $ref: "#/components/schemas/LogLevel" description: "

Sets the log level for the conversion log.

Use one\ \ of the LogLevel constants to specify the log level.

The\ \ default value is \"INFO\".

" logMaxLines: description: "

Sets the maximum amount of log entries that will be retained\ \ by the PDFreactor logs.

The default value is 100000.

A\ \ capacity of 0 is equivalent to the default value. A negative value means\ \ that the capacity will be unlimited." type: "integer" mediaFeatureValues: description: "

Defines the value of a Media Feature which is used to resolve\ \ CSS3 media queries.

" items: $ref: "#/components/schemas/MediaFeatureValue" type: "array" mediaTypes: description: "

Sets the media types that are used to resolve CSS3 media\ \ queries.

Please note that this overrides the default media types\ \ of PDFreactor, which are:

\"print\", \"paged\"\ , \"visual\", \"bitmap\", \"static\"\ , \"-ro-pdfreactor\"

" items: type: "string" type: "array" mergeDocuments: deprecated: true description: "

Deprecated as of PDFreactor 12. Use documents\ \ instead.

" items: $ref: "#/components/schemas/Resource" type: "array" mergeMode: $ref: "#/components/schemas/MergeMode" deprecated: true description: "

Deprecated as of PDFreactor 12. Use mode instead.

" mergeSettings: $ref: "#/components/schemas/MergeSettings" description: "

Configures the PDF merge settings. Specify which documents\ \ should be merged and how they should be merged (i.e. by appending, prepending\ \ or using them as an overlay.

" networkSettings: $ref: "#/components/schemas/NetworkSettings" description: "

Specifies settings for URL connections that PDFreactor\ \ establishes during the conversion to load resources.

" outputFormat: $ref: "#/components/schemas/OutputFormat" description: "

Sets the OutputFormat. If not specified, a PDF\ \ output format will be used.

For image formats the width or height\ \ in pixels must be specified.

When either dimension is <1 it is\ \ computed based on the other dimension and the aspect ratio of the input\ \ document.

" outputIntent: $ref: "#/components/schemas/OutputIntent" description: "

Sets the output intent including the identifier and the\ \ ICC profile to be embedded into the PDF.

Set either the profile\ \ URL or the profile data, not both. Certain PDF/X formats require neither,\ \ just a known identifier.

" overlayRepeat: $ref: "#/components/schemas/OverlayRepeat" deprecated: true description: "

Deprecated as of PDFreactor 12. Use overlayRepeat\ \ instead.

" ownerPassword: deprecated: true description: "

Deprecated as of PDFreactor 12. Use ownerPassword\ \ instead.

" type: "string" pageOrder: anyOf: - $ref: "#/components/schemas/PageOrder" - type: "string" description: "

Sets the page order of the direct result of the conversion.

\ \

If mergeMode is set to \"ARRANGE\", this\ \ method is also used to specify the position of inserted pages from an\ \ existing PDF.

A description of the syntax can be found in the\ \ manual.

" pagesPerSheetProperties: $ref: "#/components/schemas/PagesPerSheetProperties" description: "

Sets the properties of a sheet on which multiple pages\ \ are being arranged.

If cols or rows\ \ is less than 1, no pages-per-sheet processing is done. This is the case\ \ by default.

Use one of the PagesPerSheetDirection constants\ \ to specify the the direction. The default value is \"RIGHT_DOWN\"\ .

" pdfScriptAction: description: "

Sets a pair of trigger event and PDF script. The script\ \ is triggered on the specified event.

A PDF script is JavaScript\ \ that is executed by a PDF viewer (e.g. Adobe Reader). Note that most\ \ viewers do not support this feature.

PDF Scripts can also be\ \ set by using the proprietary CSS property pdf-script-action.\ \ More information on this property can be found in the manual.

Please\ \ note, that scripts set via CSS have a higher priority. If two scripts\ \ are registered on the same event, but one via API and the other via\ \ the CSS property, the script set in the CSS will override the other\ \ one.

" items: $ref: "#/components/schemas/PdfScriptAction" type: "array" pixelsPerInch: description: "

Sets the pixels per inch.

Changing this value changes\ \ the physical length of sizes specified in px (including those specified\ \ via HTML attributes).

The default value is 96 ppi.

" type: "integer" pixelsPerInchShrinkToFit: description: "

Whether the pixels per inch should be adapted automatically\ \ to avoid content exceeding pages.

" type: "boolean" postTransformationDocumentType: $ref: "#/components/schemas/Doctype" description: "

Sets the document type after the XSL-Transformations have\ \ been applied.

The Doctype constants can be used to specify\ \ the document type. The default value specified is \"AUTODETECT\"\ .

" printDialogPrompt: description: "

Enables or disables a print dialog to be shown upon opening\ \ the generated PDF document by a PDF viewer.

The default value\ \ is false.

" type: "boolean" processingPreferences: description: "

Preferences that influence the conversion process without\ \ changing the output.

Use the ProcessingPreferences constants\ \ to specify the processing preferences. By default no processing preference\ \ is set.

" items: $ref: "#/components/schemas/ProcessingPreferences" type: "array" quirksSettings: $ref: "#/components/schemas/QuirksSettings" description: "

Allows to enable or disable behaviors that are otherwise\ \ depend on the doctype of the input document.

" rawCookies: deprecated: true description: "

Deprecated as of PDFreactor 12. Use cookies\ \ instead.

" items: $ref: "#/components/schemas/KeyValuePair" type: "array" requestHeaders: deprecated: true description: "

Deprecated as of PDFreactor 12. Use requestHeaders\ \ instead.

" items: $ref: "#/components/schemas/KeyValuePair" type: "array" requestPriority: description: "

Specifies the priority of the conversion request. A higher\ \ priority means that the web service will adjust the conversion's position\ \ in the queue appropriately, so that it is converted before others with\ \ lower priority.

By default, asynchronous conversions have a priority\ \ of 0, synchronous conversions have a priority of 10.

" type: "integer" resourceConnectTimeout: deprecated: true description: "

Deprecated as of PDFreactor 12. Use connectTimeout\ \ instead.

" type: "integer" resourceReadTimeout: deprecated: true description: "

Deprecated as of PDFreactor 12. Use readTimeout\ \ instead.

" type: "integer" segmentationSettings: $ref: "#/components/schemas/SegmentationSettings" description: "

This property configures segmentation of the conversion,\ \ which helps with very large documents.

" signPDF: $ref: "#/components/schemas/SignPDF" description: "

Sets a digital certificate to sign the newly created PDF.

\ \

Requires a keystore file. The included certificate may be self-signed.

\ \

Use the KeystoreType constants to specify the keystore type.

\ \

Use the SigningMode constants to specify the cryptographic\ \ filter that is used for signing.

" subject: description: "

Sets the value of the subject field of the PDF document.

" type: "string" title: description: "

Sets the value of the title field of the PDF document.

" type: "string" urlRewriteSettings: $ref: "#/components/schemas/UrlRewriteSettings" description: "

Specifies settings for URL rewrites, which will transform\ \ URLs into others according to certain rules.

" userPassword: deprecated: true description: "

Deprecated as of PDFreactor 12. Use userPassword\ \ instead.

" type: "string" userScripts: description: "

Adds an user script to the document.

There are two\ \ ways to specify the script:

  1. Specifying the script only\ \ by an URI.
  2. Specifying the script by the content of the script\ \ and alternatively setting a URI to resolve relative elements. If no\ \ URI is specified then the system id/base URL of the document will be\ \ used.

Supports various ResourceSubtypes. Supported\ \ subtypes are: \"JAVASCRIPT_CLASSIC\", \"JAVASCRIPT_IMPORTMAP\"\ and \"JAVASCRIPT_MODULE\". Other values are treated\ \ as \"JAVASCRIPT_CLASSIC\".

" items: $ref: "#/components/schemas/Resource" type: "array" userStyleSheets: description: "

Adds a user style sheet to the document.

There are\ \ two ways to specify the style sheet:

  1. Specifying the style\ \ sheet only using an URI.
  2. Specifying the style sheet by the\ \ content of the style sheet and alternatively setting a URI to resolve\ \ relative elements. If no URI is specified then the system id/base URL\ \ of the document will be used.
" items: $ref: "#/components/schemas/Resource" type: "array" validateConformance: description: "

Enables PDFreactor to validate the generated PDF against\ \ the Conformance specified via conformance.

\ \

Currently only PDF/A and PDF/UA validation is supported.

Please\ \ note that validation might take several minutes for larger documents.

" type: "boolean" viewerPreferences: description: "

Sets the page layout and page mode preferences of the PDF.

\ \

Use the ViewerPreferences constants to specify the viewer\ \ preferences. By default no viewer preference is set.

" items: $ref: "#/components/schemas/ViewerPreferences" type: "array" xmp: $ref: "#/components/schemas/Xmp" description: "

Sets custom XMP to be embedded into the PDF document.

\ \

If both content and uri are not set or\ \ null no custom XMP is embedded.\ \ If XmpPriority is also set to \"HIGH\" automatic\ \ generation of required XMP is also suppressed. This may cause output\ \ PDFs to not achieve a specified conformance." xsltMode: description: "

Enables or disables XSLT transformations.

Set this\ \ value to true to enable\ \ XSLT transformations or to false\ \ to disable XSLT transformations.

The default value is false.

" type: "boolean" xsltStyleSheets: description: "

Adds an XSLT style sheet to the document.

There\ \ are two ways to specify the style sheet:

  1. Specifying the\ \ style sheet only by an URI.
  2. Specifying the style sheet by the\ \ content of the style sheet and alternatively setting a URI to resolve\ \ relative elements. If no URI is specified then the system id/base URL\ \ of the document will be used.
" items: $ref: "#/components/schemas/Resource" type: "array" required: - "document" Conformance: enum: - "PDF" - "PDFA1A" - "PDFA1A_PDFUA1" - "PDFA1B" - "PDFA2A" - "PDFA2A_PDFUA1" - "PDFA2B" - "PDFA2U" - "PDFA3A" - "PDFA3A_PDFUA1" - "PDFA3B" - "PDFA3U" - "PDFUA1" - "PDFX1A_2001" - "PDFX1A_2003" - "PDFX3_2002" - "PDFX3_2003" - "PDFX4" - "PDFX4P" type: "string" Connection: additionalProperties: false properties: cacheStatus: description: "

If a resource cache is used, indicates a status message\ \ concerning the cache status of this resource.

" type: "string" cached: description: "

Whether the response was retrieved from a cache.

" type: "boolean" connected: description: "

Whether a URL connection could be established by PDFreactor.\ \ If this is false, see\ \ error for details.

" type: "boolean" contentSize: description: "

The amount of content bytes downloaded or read from this\ \ connection.

" type: "integer" duration: description: "

The duration in milliseconds how long this connection remained\ \ open.

" type: "integer" error: description: "

The error message if the connection could not be established.

" type: "string" method: description: "

The request method used by the underlying HTTP request\ \ (like \"GET\", \"POST\", etc.) or null\ \ if this is not an HTTP connection or the connection could not be established.

" type: "string" protocol: description: "

The protocol of the URL connection.

" type: "string" requestContentSize: description: "

The amount of content bytes uploaded or written to this\ \ connection.

" type: "integer" requestHeaders: description: "

The request headers.

Note: If a header has multiple\ \ values, there will be one KeyValuePair for each value with\ \ the header name as key.

" items: $ref: "#/components/schemas/KeyValuePair" type: "array" resourceType: $ref: "#/components/schemas/ResourceType" description: "

The type of resource (style sheet, image, etc.) transferred\ \ over this connection.

" responseHeaders: description: "

The response headers.

Note: If a header has multiple\ \ values, there will be one KeyValuePair for each value with\ \ the header name as key.

" items: $ref: "#/components/schemas/KeyValuePair" type: "array" statusCode: description: "

The response code for HTTP connections or 0 for all other\ \ connections.

" type: "integer" statusMessage: description: "

The response message for the response code or null if the response code is 0 or the message\ \ could not be determined.

" type: "string" timestamp: description: "

The time stamp of this connection.

" type: "integer" url: description: "

The URL.

" format: "url" type: "string" ConnectionRuleAction: enum: - "ALLOW" - "DENY" type: "string" ConnectionSettings: additionalProperties: false properties: cookies: description: "A collection of name-value-pairs representing the cookies\ \ that will be added to the HTTP request to the PDFreactor Web Service.\ \ This property is empty by default and additional cookies can be added\ \ as required. Cookies should only be added in special environments where\ \ it is necessary, e.g. when using a load balancer. If the PDFreactor\ \ Web Service's response contains any cookies, they will be added to this\ \ property, potentially overwriting cookies with the same name." items: type: "string" type: "array" headers: description: "A collection of name-value-pairs representing the request\ \ headers that will be added to the HTTP request to the PDFreactor Web\ \ Service. This property is empty by default and additional headers can\ \ be added as required. Headers should only be added in special environments\ \ where it is necessary." items: type: "string" type: "array" ContentObserver: additionalProperties: false properties: connections: description: "

Enables observation of URL connections done by PDFreactor.

" type: "boolean" exceedingContentAgainst: $ref: "#/components/schemas/ExceedingContentAgainst" description: "

Enables observation of exceeding content either against\ \ the page edges, page content areas or containers.

" exceedingContentAnalyze: $ref: "#/components/schemas/ExceedingContentAnalyze" description: "

Enables observation of exceeding content and optionally\ \ of boxes.

" missingResources: description: "

Enables observation of resources that could not be loaded.

" type: "boolean" ContentType: enum: - "BINARY" - "BMP" - "GIF" - "HTML" - "JPEG" - "JSON" - "NONE" - "PDF" - "PNG" - "TEXT" - "TIFF" - "XML" type: "string" ContinuousOutput: additionalProperties: false properties: height: description: "

Equivalent to the height of a browser window (view port).\ \ For values <1 the entire height of the document is used.

" type: "integer" width: description: "

Equivalent to the width of a browser window (view port).\ \ Values <1 enable paginated output.

" type: "integer" Cookie: additionalProperties: false properties: domain: description: "

The domain attribute of the cookie. If null,\ \ the cookie is sent to any domain. Specifying no domain is discouraged\ \ since cross-domain cookies are not allowed according to the specification,\ \ but PDFreactor supports this behavior anyway to remain backwards compatible.

" type: "string" name: description: "

The name of the cookie. This property must be set or the\ \ cookie is considered invalid.

" type: "string" path: description: "

The path attribute of the cookie. If null,\ \ the cookie is sent to any path.

" type: "string" secure: description: "

The secure attribute of the cookie. The default value is\ \ false.

" type: "boolean" value: description: "

The value of the cookie. This property must be set or the\ \ cookie is considered invalid.

" type: "string" CookiePolicy: enum: - "DISABLED" - "RELAXED" - "STRICT" type: "string" CssPropertySupport: enum: - "ALL" - "HTML" - "HTML_THIRD_PARTY" - "HTML_THIRD_PARTY_LENIENT" type: "string" CssSettings: additionalProperties: false properties: supportQueryMode: $ref: "#/components/schemas/CssPropertySupport" description: "

Adjusts the CSS property support behavior.

" validationMode: $ref: "#/components/schemas/CssPropertySupport" description: "

Adjusts the CSS property validation behavior.

" DebugSettings: additionalProperties: false properties: all: description: "

This is a convenience property that enables the following\ \ DebugSettings:

" type: "boolean" appendLogs: description: "

Specifies whether the logs will be appended to the resulting\ \ PDF.

" type: "boolean" attachConfiguration: description: "

Specifies whether the configuration will be attached to\ \ the generated PDF.

" type: "boolean" attachDocuments: description: "

Specifies whether all debug files belonging to the group\ \ \"documents\" will be attached to the generated PDF. Please see the\ \ manual for more information.

" type: "boolean" attachLogs: description: "

Specifies whether all debug files belonging to the group\ \ \"logs\" will be attached to the generated PDF. Please see the manual\ \ for more information.

" type: "boolean" attachResources: description: "

Specifies whether all debug files belonging to the group\ \ \"resources\" will be attached to the generated PDF. Please see the\ \ manual for more information.

" type: "boolean" forceResult: description: "

Forces PDFreactor to return a result, regardless of any\ \ exceptions or errors that may have occurred during the conversion.

\ \

If an exception or error occurred during the conversion, its stack\ \ trace and the PDFreactor log is written as-is into the result data stream.\ \ This means that the resulting document will not be a valid PDF but can\ \ be opened with an appropriate text editor to view the log and errors.

" type: "boolean" Doctype: enum: - "AUTODETECT" - "HTML5" - "XHTML" - "XML" type: "string" Document: additionalProperties: false properties: id: description: "The document ID." type: "string" name: description: "The file name representing the document in the ZIP. If the\ \ document is a multi-image, you can use the '#' character in the file\ \ name as a placeholder for the page number." type: "string" Encryption: enum: - "AES_128" - "AES_256" - "NONE" - "RC4_128" - "RC4_40" - "TYPE_128" - "TYPE_40" type: "string" EncryptionSettings: additionalProperties: false properties: allowAnnotations: description: "

Enables or disables the 'annotations' restriction in the\ \ PDF document.

The default value is false.

" type: "boolean" allowAssembly: description: "

Enables or disables the 'assembly' restriction in the PDF\ \ document.

The default value is false.

" type: "boolean" allowCopy: description: "

Enables or disables the 'copy' restriction in the PDF document.

\ \

The default value is false.

" type: "boolean" allowDegradedPrinting: description: "

Enables or disables the 'degraded printing' restriction\ \ in the PDF document.

The default value is false.

" type: "boolean" allowModifyContents: description: "

Enables or disables the 'modify contents' restriction in\ \ the PDF document.

The default value is false.

" type: "boolean" allowPrinting: description: "

Enables or disables the 'printing' restriction in the PDF\ \ document.

The default value is false.

" type: "boolean" allowScreenReaders: description: "

Enables or disables the 'screen readers' restriction in\ \ the PDF document.

The default value is false.

" type: "boolean" ownerPassword: description: "

Sets the owner password of the PDF document.

" type: "string" type: $ref: "#/components/schemas/Encryption" description: "

Sets the encryption.

Use one of the Encryption\ \ constants to specify the encryption. The default value is \"NONE\"\ .

" userPassword: description: "

Sets the user password of the PDF document.

" type: "string" ErrorPolicy: enum: - "CONFORMANCE_VALIDATION_UNAVAILABLE" - "IGNORE_INVALID_MERGE_DOCUMENTS_EXCEPTION" - "LICENSE" - "MISSING_RESOURCE" - "UNCAUGHT_JAVASCRIPT_EXCEPTION" - "WARN_EVENT" type: "string" ExceedingContent: additionalProperties: false properties: bottom: description: "

Returns whether the content exceeds the page at the bottom.

" type: "boolean" box: description: "

Returns whether the exceeding content is a box instead\ \ of text or image content.

" type: "boolean" containerBottom: description: "

Returns the bottom coordinate of the the container box\ \ in the page in pixels. Depending on the settings this box may be the\ \ page.

" type: "integer" containerLeft: description: "

Returns the left coordinate of the the container box in\ \ the page in pixels. Depending on the settings this box may be the page.

" type: "integer" containerRight: description: "

Returns the right coordinate of the the container box in\ \ the page in pixels. Depending on the settings this box may be the page.

" type: "integer" containerTop: description: "

Returns the top coordinate of the the container box in\ \ the page in pixels. Depending on the settings this box may be the page.

" type: "integer" description: description: "

Returns a description of the content. In case of text content,\ \ the text is returned. In case of images the URL is returned if available.

" type: "string" exceedingBoxBottom: description: "

Returns the bottom coordinate of the the exceeding box\ \ in the page in pixels.

" type: "integer" exceedingBoxLeft: description: "

Returns the left coordinate of the the exceeding box in\ \ the page in pixels.

" type: "integer" exceedingBoxRight: description: "

Returns the right coordinate of the the exceeding box in\ \ the page in pixels.

" type: "integer" exceedingBoxTop: description: "

Returns the top coordinate of the the exceeding box in\ \ the page in pixels.

" type: "integer" html: description: "

Returns the HTML of the box that contains the exceeding\ \ content.

" type: "string" left: description: "

Returns whether the content exceeds the page to the left.

" type: "boolean" pageBottom: description: "

Returns the bottom coordinate of the the page in pixels.

" type: "integer" pageLeft: description: "

Returns the left coordinate of the the page in pixels.

" type: "integer" pageNumber: description: "

Returns the number of the page that contains the exceeding\ \ content.

" type: "integer" pageRight: description: "

Returns the right coordinate of the the page in pixels.

" type: "integer" pageTop: description: "

Returns the top coordinate of the the page in pixels.

" type: "integer" path: description: "

Returns an array of integers denoting the indexes of the\ \ ancestors of the DOM node corresponding to the box containing the exceeding\ \ content, starting from below the root node down to the element itself.

" items: type: "integer" type: "array" right: description: "

Returns whether the content exceeds the page to the right.

" type: "boolean" summary: description: "

Returns a summary of this exceeding content object.

" type: "string" top: description: "

Returns whether the content exceeds the page at the top.

" type: "boolean" ExceedingContentAgainst: enum: - "NONE" - "PAGE_BORDERS" - "PAGE_CONTENT" - "PARENT" type: "string" ExceedingContentAnalyze: enum: - "CONTENT" - "CONTENT_AND_BOXES" - "CONTENT_AND_STATIC_BOXES" - "NONE" type: "string" Font: additionalProperties: false properties: bold: description: "

Whether the alias will be labeled bold.

" type: "boolean" family: description: "

The alias name for that font.

" type: "string" italic: description: "

Whether the alias will be labeled italic.

" type: "boolean" source: description: "

The source URL of the font (when adding new fonts) or the\ \ name of an existing font family (when creating an alias).

" type: "string" HttpAuthScheme: enum: - "ANY" - "BASIC" - "DIGEST" - "KERBEROS" - "NTLM" - "SPNEGO" type: "string" HttpCredentials: additionalProperties: false properties: authScheme: $ref: "#/components/schemas/HttpAuthScheme" description: "

The authentication scheme for which these credentials are\ \ intended to be used.

A value of null\ \ means any scheme.

" host: description: "

The host for which these credentials are intended to be\ \ used.

A value of null\ \ means any host.

" type: "string" password: description: "

The authentication password.

" type: "string" port: description: "

The port for which these credentials are intended to be\ \ used.

A value of null\ \ or -1 means any port.

" type: "integer" protocol: $ref: "#/components/schemas/HttpProtocol" description: "

The protocol for which these credentials are intended to\ \ be used.

A value of null means\ \ any protocol.

" realm: description: "

The realm for which these credentials are intended to be\ \ used.

A value of null\ \ means any realm.

" type: "string" username: description: "

The authentication user name.

" type: "string" HttpProtocol: enum: - "ANY" - "HTTP" - "HTTPS" type: "string" HttpsMode: enum: - "LENIENT" - "STRICT" type: "string" InspectableSettings: additionalProperties: false properties: enabled: description: "

Specifies whether to make the document inspectable.

" type: "boolean" endPage: description: "

Specifies an optional page number below which the DOM is\ \ not inspected.

Page numbers start at 1. The default 0 goes up\ \ the last page. Other values are inclusive.

" type: "integer" startPage: description: "

Specifies an optional page number below which the DOM is\ \ not inspected.

Page numbers start at 1. The default 0 starts\ \ at the first page.

" type: "integer" JavaScriptDebugMode: enum: - "EXCEPTIONS" - "FUNCTIONS" - "LINES" - "NONE" - "POSITIONS" type: "string" JavaScriptEngine: enum: - "GRAALJS" - "RHINO" type: "string" JavaScriptRecord: additionalProperties: false properties: level: description: "The level of the record." type: "integer" levelName: description: "The textual representation of the level." type: "string" message: description: "The logged message." type: "string" sourceLocationInfo: $ref: "#/components/schemas/SourceLocationInfo" description: "The logged message." timestamp: description: "The timestamp." type: "integer" JavaScriptSettings: additionalProperties: false properties: debugIndentation: description: "

Specifies the amount of spaces per indentation level when\ \ using JavaScript debugging.

The default value is 0.

Note:\ \ This setting does not apply to the \"GRAALJS\" JavaScipt\ \ engine.

" type: "integer" debugMode: $ref: "#/components/schemas/JavaScriptDebugMode" description: "

Specifies the debug mode.

Any other value than the\ \ default \"NONE\" impacts performance significantly and\ \ should not be used in production.

Note: This\ \ setting does not apply to the \"GRAALJS\" JavaScipt engine.

" disabled: description: "

Specifies whether to not process JavaScript.

" type: "boolean" enabled: deprecated: true description: "

Deprecated as of PDFreactor 12. Use disabled\ \ instead.

" type: "boolean" ignoreScriptElements: description: "

Specifies whether to ignore