Saltar al contenido

Combinar la API pública con los webhooks

Recibe un aviso cuando algo cambia (pedidos, productos, stock, clientes) y lee el detalle con la API, sin consultar cada minuto.

La idea

Los webhooks avisan; la API trae los datos. En lugar de preguntar cada minuto si hay pedidos nuevos, suscríbete a los eventos y, cuando llegue uno, pide el detalle con tu clave de API.

Suscribirse a los eventos

  1. Ve a Tienda online › Ajustes de la tienda online › Webhooks.
  2. Crea una suscripción con tu dirección https:// y elige los eventos: order.created, order.paid, order.cancelled, product.updated, inventory.changed y customer.created.
  3. Guarda el secreto de firma: se enseña una vez.

Al recibir un evento

  1. Comprueba la firma: la cabecera X-Bizq-Signature lleva v1= y el HMAC-SHA256 del secreto sobre X-Bizq-Timestamp, un punto y el cuerpo. Rechaza lo que no cuadre o sea antiguo.
  2. Responde enseguida con un 2xx. Si no, BizQ reintenta durante 24 horas.
  3. Lee el detalle con la API: por ejemplo GET /api/v1/public/v1/orders/ID tras order.created, o GET /api/v1/public/v1/stock?productId=ID tras inventory.changed.

Consejos

  • Un mismo evento puede llegar dos veces: usa X-Bizq-Delivery-Id para no procesarlo dos veces.
  • Como red de seguridad, haz una sincronización periódica con updatedSince (por ejemplo, cada noche) por si se perdió algún aviso.
  • Para crear pedidos desde tu web usa POST /orders con Idempotency-Key: un reintento nunca crea un pedido doble.
Volver al centro de ayuda