API & Integrationen

Verbinden Sie ImprimeBay mit Ihrer Verwaltungssoftware ueber unsere REST-API. Lesen Sie Bestellungen, aktualisieren Sie Status und verwalten Sie Ihren Katalog. Verfuegbar mit dem Premium-Plan.

Authentifizierung

Generieren Sie Ihren API-Schluessel in den Dashboard-Einstellungen (Bereich Integrationen). Fuegen Sie ihn in jede Anfrage im Authorization-Header ein:

Authorization: Bearer ib_live_xxxxxxxxxxxxx

Basis-URL: https://imprimebay.com/api/v1/public

Endpunkte

GET/orders

Listen Sie Ihre Bestellungen auf. Optionaler Filter ?status=SHIPPED

curl -H "Authorization: Bearer ib_live_..." \
  https://imprimebay.com/api/v1/public/orders

GET/orders/:id

Bestelldetails mit Statusverlauf.

curl -H "Authorization: Bearer ib_live_..." \
  https://imprimebay.com/api/v1/public/orders/ORDER_ID

PATCH/orders/:id/status

Aktualisieren Sie einen Bestellstatus. Werte: ACCEPTED, IN_PRODUCTION, READY, READY_PICKUP, SHIPPED, DELIVERED, CANCELED

curl -X PATCH -H "Authorization: Bearer ib_live_..." \
  -H "Content-Type: application/json" \
  -d '{"status":"SHIPPED"}' \
  https://imprimebay.com/api/v1/public/orders/ORDER_ID/status

GET/products

Listen Sie Ihre Katalogprodukte auf.

curl -H "Authorization: Bearer ib_live_..." \
  https://imprimebay.com/api/v1/public/products

GET/products/:id

Produktdetails.

curl -H "Authorization: Bearer ib_live_..." \
  https://imprimebay.com/api/v1/public/products/PRODUCT_ID

PATCH/products/:id

apiDocs.ep_productUpdate

curl -X PATCH -H "Authorization: Bearer ib_live_..." \
  -H "Content-Type: application/json" \
  -d '{"isActive":false}' \
  https://imprimebay.com/api/v1/public/products/PRODUCT_ID

GET/stats

Statistiken: Bestellungen gesamt, bezahlt, Umsatz, nach Status.

curl -H "Authorization: Bearer ib_live_..." \
  https://imprimebay.com/api/v1/public/stats

Hinweis: Jeder Schluessel greift nur auf die Daten der eigenen Druckerei zu. Anfragen sind auf 30 pro Minute begrenzt. Der Schluessel kann jederzeit ueber das Dashboard neu generiert oder widerrufen werden.