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
- Ve a Tienda online › Ajustes de la tienda online › Webhooks.
- Crea una suscripción con tu dirección
https://y elige los eventos:order.created,order.paid,order.cancelled,product.updated,inventory.changedycustomer.created. - Guarda el secreto de firma: se enseña una vez.
Al recibir un evento
- Comprueba la firma: la cabecera
X-Bizq-Signaturellevav1=y el HMAC-SHA256 del secreto sobreX-Bizq-Timestamp, un punto y el cuerpo. Rechaza lo que no cuadre o sea antiguo. - Responde enseguida con un 2xx. Si no, BizQ reintenta durante 24 horas.
- Lee el detalle con la API: por ejemplo
GET /api/v1/public/v1/orders/IDtrasorder.created, oGET /api/v1/public/v1/stock?productId=IDtrasinventory.changed.
Consejos
- Un mismo evento puede llegar dos veces: usa
X-Bizq-Delivery-Idpara 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 /ordersconIdempotency-Key: un reintento nunca crea un pedido doble.