API & Integrazioni

Collega ImprimeBay al tuo gestionale con la nostra REST API. Leggi gli ordini, aggiorna gli stati e gestisci il catalogo dal tuo sistema. Disponibile con il piano Premium.

Autenticazione

Genera la tua chiave API dalle impostazioni della dashboard (sezione Integrazioni). Includila in ogni richiesta nell’header Authorization:

Authorization: Bearer ib_live_xxxxxxxxxxxxx

Base URL: https://imprimebay.com/api/v1/public

Endpoint

GET/orders

Elenca i tuoi ordini. Filtro opzionale ?status=SHIPPED

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

GET/orders/:id

Dettaglio di un ordine, con cronologia stati.

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

PATCH/orders/:id/status

Aggiorna lo stato di un ordine. Valori: 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

Elenca i prodotti del tuo catalogo.

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

GET/products/:id

Dettaglio di un prodotto.

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

Statistiche: ordini totali, pagati, fatturato, per stato.

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

Nota: ogni chiave accede esclusivamente ai dati della propria tipografia. Le richieste sono limitate a 30 al minuto. La chiave puo essere rigenerata o revocata in qualsiasi momento dalla dashboard.