API e Integraciones

Conecta ImprimeBay a tu software de gestion con nuestra REST API. Lee pedidos, actualiza estados y gestiona el catalogo desde tu sistema. Disponible con el plan Premium.

Autenticacion

Genera tu clave API desde los ajustes del panel (seccion Integraciones). Incluyela en cada solicitud en el encabezado Authorization:

Authorization: Bearer ib_live_xxxxxxxxxxxxx

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

Endpoints

GET/orders

Lista tus pedidos. Filtro opcional ?status=SHIPPED

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

GET/orders/:id

Detalle de un pedido, con historial de estados.

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

PATCH/orders/:id/status

Actualiza el estado de un pedido. Valores: 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

Lista los productos de tu catalogo.

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

GET/products/:id

Detalle de un producto.

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

Estadisticas: pedidos totales, pagados, facturacion, por estado.

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

Nota: cada clave accede solo a los datos de su propia imprenta. Las solicitudes estan limitadas a 30 por minuto. La clave se puede regenerar o revocar en cualquier momento desde el panel.