ConneoPrint Uploader
ConneoPrint API
The ConneoPrint API enables you to integrate our upload functionality into your webshop or system. With a simple REST API, you can manage sessions, upload files, and generate print-ready PDFs.
Getting Started
To get started with the ConneoPrint API you need:
- Authentication credentials: Contact us for a trial license
- Base URL: Contact us for this information
- SSL: All API calls must be via HTTPS
Authentication
Authorization: YOUR_API_KEY (only in combination with the parameter :conneoId)
Workflow
- Create session: Start a new upload session with product specifications
- Upload files: Upload files via the web interface
- Check upload session: Verify all files are uploaded correctly
- Get preview: Retrieve preview images for your webshop
- Production: Generate print-ready files when customer confirms
Error Handling
The API returns standard HTTP status codes:
200
- Success400
- Bad Request (invalid parameters)401
- Unauthorized (invalid API key)404
- Not Found (session does not exist)500
- Internal Server Error
POST
/api/config
New Upload
Parameters
productSize.width
number
width parameter
productSize.height
number
height parameter
bleed.left
number
left parameter
bleed.right
number
right parameter
bleed.top
number
top parameter
bleed.bottom
number
bottom parameter
sidesCount
number
sidesCount parameter
quantity
number
quantity parameter
myId
number
myId parameter
options.showBleedMarker
boolean
showBleedMarker parameter
options.minimalDpi
number
minimalDpi parameter
Request Body
{
"productSize": {
"width": 1050,
"height": 700
},
"bleed": {
"left": 20,
"right": 20,
"top": 20,
"bottom": 20
},
"sidesCount": 2,
"quantity": 5,
"myId": 2,
"options": {
"showBleedMarker": true,
"minimalDpi": 72
}
}
POST
/api/:conneoId/sessions/:sessionId/confirm
Confirm
Parameters
confirmed
boolean
confirmed parameter
Request Body
{
"confirmed": true
}
POST
/api/:conneoId/:sessionId/production-files
production-files
Parameters
options.productionBleed
number
productionBleed parameter
options.description
string
description parameter
options.disableCutMarks
boolean
disableCutMarks parameter
Request Body
{
"options": {
"productionBleed": 10,
"description": "Order number 1234",
"disableCutMarks": false
}
}
GET
/api/:conneoId/:sessionId/assets
Assets (uploaded files)
Request Body
{}
GET
/api/:conneoId/:sessionId/products
Products
Parameters
production
query