Skip to main content

FAQ: Print API

Can I use your print API if I’m not a developer?

Our print API has primarily been designed for developers. You will need to either be a developer yourself or have access to a programmer in order to make full use of it.

We wanted to make our global print network accessible to a whole range of creators. Hence, we created the Shopify print on demand app.

The Shopify print app allows you to have the same automatic integration as the API, without the need for a developer or programmer. Simply download the Prodigi app to your Shopify store, upload your artwork, pick your products and start selling.

Alternatively, if you are an account holder, you can order using our manual order form.

For consumers wishing to order online, visit Canvas Republic for photo canvas deals or Magnolia Box for discount fine art prints.

What’s the difference between Sandbox and Live?

Live is our production environment. All orders that get created through the live API (i.e api.prodigi.com) will be charged and routed through to labs as you’d expect.

Sandbox (i.e api.sandbox.prodigi.com) does not charge and does not fulfil any orders. Its primary purpose is for merchants to come and try out the API in a semi-real way without risk of being charged or accidentally ordering something.

We keep the sandbox environment as up-to-date as our live environment, so you’ll always see the newest features on both.

How do I find my API keys?

Once you’ve registered we’ll send you an email containing your live and sandbox API keys.

You can also view these at any time by going to the dashboard, clicking on the gear icon in the top right hand corner of the screen and then pressing the show API key button; you can go between live and sandbox by pressing the buttons at the top.

Do Sandbox and Live have different API keys?

Yes. You cannot use your Sandbox API Keys on Live and vice versa.

Why am I seeing different prices for Sandbox and Live?

Whilst we make every effort to ensure data parity between these environments, it’s not always spot on. If there is a discrepancy, Live is always the most up to date and accurate.

If you do see a price difference, please get in touch and we will amend the data.

How do I reset my API keys?

Go to your settings (the gear icon) on the dashboard and press the “Show API keys” button. There is then an option to regenerate your API Keys. You need to do this for both live and sandbox.

What image file types does the API accept?

Our API currently only accepts jpg, png or pdf files. However, the image required is often product specific. Most products require either jpg or png.

What happens if the image does not fit the product print area?

If your image does not fit the product size, by default we will crop your image centrally. We print the image as large as possible, removing the top/bottom or left/right parts of the image that go beyond the print area.

However, you can also specify a sizing parameter to change this behaviour.

**Crop (default): **your image will be centred and cropped so that it exactly fits the aspect ratio (height divided by width) of the printing area of the product you chose. Your image will cover all of the product print area.

ShrinktoFit: your image will be resized so that it completely fills the print area of the product, If the aspect ratio of your image is different to that of the printing area, your image will be stretched or squashed to fit.

Rotation Our print API will automatically rotate your images so that they need the least possible resizing to fit the product size. For example, if you are creating a 10x15 photo, and upload an image that is 4500x3000px, then we will flip it so it is 3000x4500px and thus fits the photo perfectly.

How do I add multiple images to an order as a batch?

You just need to send a JSON array of order items, e.g. [ ` { ` ` “type”:”4x6”, “url”:”https://…” }, { ` ` “type”:”5x7”, “url”:”https://…” } ]`

Do you have any examples of companies that are already integrated with the API?

Yes! Posterhaste, Oddprints, 23snaps, Wedpics and Instaprnt are all using our Print API.