Cloud REST API

Cloud REST API

The Cloud REST API gives access to your complete production infrastructure, both on-premises as in the cloud, that is linked to your company its account.

The API defines an interface to the following elements:

  • Jobs
  • Documents
  • Resources
  • Configuration
  • Nester
  • Logs

Jobs

Jobs can refer to one or more documents and to resources. The job contains the document list and optionally the imposition schema (layout), print mode, operations (workflow steps) and other specific instructions for the printer or cutter. For more information about the job structure refer to the job documentation.
The job is defined using XML, for which there is an XSD and documentation.

Resources

Resources are items like labels, calibrations, templates, etc. The resources are versioned and its history is retained for 30 days. Jobs, documents and devices are not versioned and modifications are immediate.

Configurations

Configuration contains of devices, queues and RIPs.
Devices are the printers and cutters as available to the account. Devices are assigned to sites, which are identified by the site serial number. Moving devices from one site to another and site management is only available in the cloud-UI. Moving devices between RIPs and set-up of the devices is available through the API.
Queues are local automated processes, that are also accessible via local hotfolders. Jobs can be send directly to the device when the are production ready and contain an imposition and print-mode. Alternatively they can be send to a queue first, who will execute the defined pre-processing steps, including creating an imposition and setting the print-mode.
RIPs are individual computers that perform the heavy weight lifting and executes all instructions in the job, renders it to the resolution and ink-set of the printer, performs color management and encodes to the format accepted by the device.

Nesting

Automation describes the cloud based nesting, thus before assigning it to a device or site. The cloud based nesting allows to define JIT-nesting and job processing.

The REST calls are made over HTTPS to api.aurelon.com in all regions besides China, where api.aurelon.cn is to be used. To authenticate the calling application specific headers are required. Information about the authentication can be found in the chapter Authentication.

Notifications

Feedback on the status of jobs and devices after they have been created using the REST API are send using a WebSocket server. After opening a WebSocket connection your application can subscribe to the events its want to receive and will get those events through this channel. Details about the websocket API can be found in the chapter Notifications.

API Documentation

All APIs are documented on https://api.printfactory.cloud.

XML generator

In Cloud app an XML generator is available to assist generating XML samples. It provides most generic job requirements. Found in: app.prinfactory.cloud -> support tab -> XML generator.

API Examples

  • Postman : Postman allows to directly work with the api after filling in the variables and selecting the region. After that code is generated in the language of choice.

    • Related Articles

    • Layout Tiling: adding Tile Rest

      What is a Tile Rest When using set widths in tiling and the full image does not completely fit, the tile rest allow to divide still in equal round number tiles, but the last remnant is added to the last tile. E.g. image width of 2001mm => tiling in ...
    • Cloud Certification

      By default a QR code is printed next to the Certification strips. This feature allows you to : certify jobs remotely share the certification results online pull the certification results via a mobile scannable QR code still certify jobs that are no ...
    • Color bars option in Cloud Nesting Queues

      Color bars can also be added to Cloud nesting Jobs. They can be added either on one or both sides of the nested job and define the width of the total bars, similar to the Layout function and The difference with the Layout feature is that Color bars ...
    • Configuring cloud connection for secure environments or proxy servers

      PrintFactory uses the LicenseServer service to connect to its cloud infrastructure. The LicenseServer acts as a proxy for all applications. By acting as a proxy there is no need to have Internet access on the production floor as long as the ...
    • Job XML generator for Cloud nest jobs

      This documentation explain each element in the XML generator at https://app.printfactory.cloud/automation/xmlgenerator The XML generator is a quick way to compile a sample next job. For the full documentation of the job format and API please consult ...