Getting Started with the PrintOS Composer API

PrintOS

HP PrintOS is an operating system for Print Service Providers (PSPs) of all sizes and across all segments to help them improve their operations and profitability, and drive performance and growth. PrintOS is built on industry-leading security and privacy standards, is cloud-based, IT-free, and open. And it's accessible any time, anywhere. 

Not a current user of HP PrintOS? For more information on HP PrintOS and it's capabilities or to sign up for a PrintOS account click this link: Learn More about HP PrintOS

Overview:

The PrintOS Composer application has a RESTful API which provides an authenticated method for securely uploading files for generation of variable data and imposed jobs within the PrintOS cloud platform.  The steps below will help you get started with this API.

Getting Started:

  1. Visit the Authentication page.
  • Follow the directions for generating a Key/Secret within your PrintOS account.
    • If you are not a current PrintOS user or not working with an existing PrintOS user you can use the request form to request a development account. Provide as much detail as possible about what HP products you are working with, and what you are trying to accomplish with your solution.
  • Look over the documentation regarding the HMAC authentication headers and how to generate them.
  1. To read an overview of what the PrintOS Composer API is and how it works read the Composer Overview
  2. Head to the Documentation for information about each API endpoint.
  3. See examples of real-world calls needed to upload resources and compose a VDP output on the Composer Example Workflow page.
  4. Make API calls against your PrintOS account and see response messages from the API Test Page.
  5. To download code samples of authentication and API usage visit our GitHub repository.

Authentication:

Certain HTTP headers are required to authenticate the API calls. These headers are generated using a current timestamp following the ISO 8601 format and a Key/Secret combination. Without the headers, you will receive an authentication required error. The Key/Secret is generated from within your PrintOS account. For more in-depth information on generating these headers see the Authentication page.

Questions / Feedback:

Notice any issues or require assistance? Visit our support forums and ask any questions you have. A forum support member will usually respond within 24 hours to assist you.