REST API Reference

The PlanetPress Connect REST API defines a number of RESTful services that facilitate various functionality within the server during workflow processing.

The following table is a summary of the services available in the PlanetPress Connect REST API:

Service Name Internal Name Description

Authentication Service

AuthenticationRestService

This service exposes methods concerned with server security and authentication with the PlanetPress Connect REST API.

It includes methods to facilitate the following functions:

  • Authentication with the server (username & password / token based authorization)

Content Creation Service

ContentCreationRestService

This service exposes methods specific to the management of the content creation process for the Print context within the workflow.

It includes methods to facilitate the following functions:

  • Creation, monitoring and cancellation of content creation operations for print using either a data set, data records or JSON as input

  • Getting a list of all the active operations on the server

  • Getting the result of a content creation operation for print

  • Creation of single record preview PDFs using either a data file, data record or JSON as input

Content Item Entity Service

ContentItemEntityRestService

This service exposes methods specific to the access and management of content item entities internal to the server.

It includes methods to facilitate the following functions:

  • Getting the data record ID associated with a content item

  • Getting and updating of content item properties

Content Set Entity Service

ContentSetEntityRestService

This service exposes methods specific to the access and management of content set entities internal to the server.

It includes methods to facilitate the following functions:

  • Getting all the content set IDs within the server

  • Getting the content item IDs contained within a content set

  • Getting the page details for a content set

  • Getting and updating of content set properties

  • Deletion of content sets from the server

Data Record Entity Service

DataRecordEntityRestService

This service exposes methods specific to the access and management of data record entities internal to the server.

It includes methods to facilitate the following functions:

  • Addition of new data records to a data set

  • Addition of new nested data records to a data record

  • Getting and updating of data record values

  • Getting and updating of data record properties

Data Set Entity Service

DataSetEntityRestService

This service exposes methods specific to the access and management of data set entities internal to the server.

It includes methods to facilitate the following functions:

  • Getting all the data set IDs within the server

  • Getting the data record IDs contained within a data set

  • Getting and updating of data set properties

  • Deletion of data sets from the server

Data Mapping Service

DataminingRestService

This service exposes methods specific to the management of the data mapping process within the workflow.

It includes methods to facilitate the following functions:

  • Creation, monitoring, cancellation and validation of data mapping operations using a data file as input

  • Creation, monitoring and cancellation of data mapping operations using a PDF/VT file as input

  • Getting a list of all the active operations on the server

  • Getting the result of a data mapping operation

Document Entity Service

DocumentEntityRestService

This service exposes methods specific to the access and management of document entities internal to the server.

It includes methods to facilitate the following functions:

  • Getting and updating of document metadata properties

Document Set Entity Service

DocumentSetEntityRestService

This service exposes methods specific to the access and management of document set entities internal to the server.

It includes methods to facilitate the following functions:

  • Getting the document IDs contained within a document set

  • Getting and updating of document set metadata properties

Content Creation (Email) Service

EmailExportRestService

This service exposes methods specific to the management of the content creation process for the Email context within the workflow.

It includes methods to facilitate the following functions:

  • Creation, monitoring and cancellation of content creation operations for email using data records or JSON as input

  • Getting a list of all the active operations on the server

  • Getting the result of a content creation operation for email

Entity Service

EntityRestService

This service exposes methods specific to the querying and selection of data entities internal to the server.

It includes methods to facilitate the following functions:

  • Finding of data entities in the server using specific search criteria

File Store Service

FilestoreRestService

This service exposes methods specific to the management of input and output files via the file store on the PlanetPress Connect server.

It includes methods to facilitate the following functions:

  • Uploading of data files and data mapping configurations to the file store

  • Uploading of design templates to the file store

  • Uploading of job creation and output creation presets to the file store

  • Download of managed files from the file store

  • Deletion of managed files from the file store

Content Creation (HTML) Service

HTMLMergeRestService

This service exposes methods specific to the management of the content creation process for the Web context within the workflow.

It includes methods to facilitate the following functions:

  • Creation of HTML output for a specific data record or JSON input

  • Creation of HTML output from a design template only (no input data)

  • Getting specific resources contained within a design template

Job Creation Service

JobCreationRestService

This service exposes methods specific to the management of the job creation process within the workflow.

It includes methods to facilitate the following functions:

  • Creation, monitoring and cancellation of job creation operations using either content sets or content items as input

  • Getting a list of all the active operations on the server

  • Getting the result of a job creation operation

Job Entity Service

JobEntityRestService

This service exposes methods specific to the access and management of job entities internal to the server.

It includes methods to facilitate the following functions:

  • Getting the data record and content item IDs associated with a job

  • Getting the job segment IDs contained within a job

  • Getting and updating of job properties

  • Getting and updating of job metadata properties

Job Segment Entity Service

JobSegmentEntityRestService

This service exposes methods specific to the access and management of job segment entities internal to the server.

It includes methods to facilitate the following functions:

  • Getting the document set IDs contained within a job segment

  • Getting and updating of job segment metadata properties

Job Set Entity Service

JobSetEntityRestService

This service exposes methods specific to the access and management of job set entities internal to the server.

It includes methods to facilitate the following functions:

  • Getting all the job set IDs within the server

  • Getting the job IDs contained within a job set

  • Getting and updating of job set properties

  • Getting and updating of job set metadata properties

  • Deletion of job sets from the server

Output Creation Service

OutputCreationRestService

This service exposes methods specific to the management of the output creation process within the workflow.

It includes methods to facilitate the following functions:

  • Creation, monitoring and cancellation of output creation operations using either a job set or jobs as input

  • Getting a list of all the active operations on the server

  • Getting the result of an output creation operation

  • Running of +PReS Enhance workflow configurations via the Weaver engine

All-In-One Service

PrintRestService

This service exposes methods specific to the management of the All-In-One process within the workflow.

It includes methods to facilitate the following functions:

  • Creation, monitoring and cancellation of All-In-One operations using a variety of managed file and data entity input combinations

  • Creation of synchronous All-In-One operations using a data file as input

  • Getting a list of all the active operations on the server

  • Getting the result of an All-In-One operation