API et Integrations

Connectez ImprimeBay a votre logiciel de gestion avec notre API REST. Lisez les commandes, mettez a jour les statuts et gerez votre catalogue depuis votre systeme. Disponible avec le plan Premium.

Authentification

Generez votre cle API depuis les parametres du tableau de bord (section Integrations). Incluez-la dans chaque requete dans l’en-tete Authorization :

Authorization: Bearer ib_live_xxxxxxxxxxxxx

URL de base: https://imprimebay.com/api/v1/public

Endpoints

GET/orders

Listez vos commandes. Filtre optionnel ?status=SHIPPED

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

GET/orders/:id

Detail d’une commande, avec historique des statuts.

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

PATCH/orders/:id/status

Mettez a jour le statut d’une commande. Valeurs : 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

Listez les produits de votre catalogue.

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

GET/products/:id

Detail d’un produit.

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

Statistiques : commandes totales, payees, chiffre d’affaires, par statut.

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

Note : chaque cle accede uniquement aux donnees de sa propre imprimerie. Les requetes sont limitees a 30 par minute. La cle peut etre regeneree ou revoquee a tout moment depuis le tableau de bord.