ConneoPrint Uploader

Conneo Print API

De Conneo Print API maakt het mogelijk om onze upload-functionaliteit te integreren in uw webshop of systeem. Met een eenvoudige REST API kunt u sessies beheren, bestanden uploaden en drukklare PDF's genereren.

Getting Started

Om te beginnen met de Conneo Print API hebt u nodig:

  1. Authenticatie gegevens: Neem contact op voor een proeflicentie
  2. Base URL: Neem contact op voor deze informatie
  3. SSL: Alle API calls moeten via HTTPS

Authentication

Authorization: YOUR_API_KEY  (alleen in combinatie met de parameter :conneoId)

Workflow

  1. Sessie aanmaken: Start een nieuwe upload sessie met product specificaties
  2. Bestanden uploaden: Upload bestanden via de web interface
  3. Uploadsessie controleren: Controleer of alle bestanden correct zijn geupload
  4. Preview ophalen: Haal preview afbeeldingen op voor uw webshop
  5. Productie: Genereer drukklare bestanden wanneer de klant bevestigt

Error Handling

De API retourneert standaard HTTP status codes:

  • 200 - Success
  • 400 - Bad Request (ongeldige parameters)
  • 401 - Unauthorized (ongeldige API key)
  • 404 - Not Found (sessie bestaat niet)
  • 500 - Internal Server Error
⚙️

Upload Interface Aanpassen

  • Volledige UI Controle: Toon of verberg elk UI element inclusief toolbox knoppen, zijbalken, en kwaliteitsindicatoren
  • Aangepaste Tekst & Tooltips: Overschrijf standaard tekst en tooltips met uw eigen inhoud
  • Gedetailleerde Configuratie: Beheer elk aspect van upload functionaliteit tot individuele knop zichtbaarheid
  • Eenvoudige Integratie: JSON-gebaseerde configuratie die naadloos werkt met sessie aanmaak

Wilt u de upload interface aanpassen voor uw gebruikers? Configureer welke UI elementen getoond of verborgen worden, pas tooltips aan, en beheer de complete gebruikerservaring.

🔧 Bekijk UI Configuratie Gids →

Create Session

POST /api/:conneoId/sessions 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
conneoId
string
conneoId parameter
fileUrl
string
fileUrl parameter
options.showBleedMarker
boolean
showBleedMarker parameter
options.minimalDpi
number
minimalDpi parameter
options.variantsConfig.maxCount
number
maxCount parameter
options.variantsConfig.needsExactCount
boolean
needsExactCount parameter

Request Body

{ "productSize": { "width": 1050, "height": 700 }, "bleed": { "left": 20, "right": 20, "top": 20, "bottom": 20 }, "sidesCount": 2, "quantity": 10, "myId": 2, "conneoId": "<your conneoId>", "fileUrl": "<optional url to PDF file to preload in the upload session>", "options": { "showBleedMarker": true, "minimalDpi": 72, "variantsConfig": { "maxCount": 5, "needsExactCount": false } } }

Check upload session

POST /api/:conneoId/sessions/:sessionId/confirm Confirm ▶

Parameters

confirmed
boolean
confirmed parameter

Request Body

{ "confirmed": true }

Get previews

GET /api/:conneoId/:sessionId/products Products ▶

Parameters

production
query

Generate production files

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

{}

Products & Variants Management

POST /api/:conneoId/:sessionId/products Add Product (Create Variant) ▶
PUT /api/:conneoId/:sessionId/products/:productId Update Product Count ▶

Parameters

count
number
count parameter

Request Body

{ "count": 3 }
DELETE /api/:conneoId/:sessionId/products/:productId Delete Product (Remove Variant) ▶