Los webhooks salientes todavía no están disponibles. Esta página describe lo
previsto para que puedas diseñar tu integración sin tener que rehacerla después.
Mientras tanto: sondeo incremental
Para casi todos los casos, consultar cada 30 segundos conupdated_since o
since da la misma información con una complejidad mucho menor. Ver
Paginación.
Con el cupo de 120 peticiones por minuto, sondear cada 30 segundos consume dos.
Lo previsto
Eventos que se emitirán:Formatos
Además del formato JSON propio, habrá salida directa a Discord y Slack mediante sus webhooks entrantes, para poder poner avisos operativos en un canal del equipo sin escribir código: acreditaciones duplicadas, accesos denegados en una puerta concreta o pulseras bloqueadas.Entrega
- Firma
HMAC-SHA256en la cabeceraX-Ventry-Signature, sobre el cuerpo crudo. - Reintentos con espera creciente ante respuestas distintas de
2xx. - Reenvío manual desde el panel de VENTRY.
- Entrega al menos una vez: tu receptor tendrá que ser idempotente y deduplicar por el identificador del evento.
Qué puedes hacer ya para prepararte
Haz idempotente tu receptor
Haz idempotente tu receptor
Sea por sondeo o por webhook, vas a ver el mismo registro más de una vez.
Deduplica por el
id del recurso, no por el orden de llegada.No supongas orden
No supongas orden
Un terminal sin cobertura sincroniza en bloque. Puedes recibir una venta de
las 22:00 después de otra de las 23:00. Ordena por
occurred_at en tu lado.Separa ingesta de proceso
Separa ingesta de proceso
Guarda lo que recibes y procésalo aparte. Es lo que te permitirá cambiar el
sondeo por webhooks sin tocar tu lógica de negocio.