Webhooks, eventos y reintentos: la plataforma vuelve a llamar, con educación
Cómo suscripciones, secretos de firma, historial de entrega, retry y replay hacen observables las integraciones salientes.
Los webhooks son cómo ReVend OS le dice a otro sistema que algo pasó: activo creado, pedido completado, listing publicado, puja colocada, escrow financiado, acuerdo cerrado. Sin historial de entrega, un webhook es gritarle a internet y esperar que internet tenga modales.
Suscripciones
/settings/api/webhooks permite a admins gestionar suscripciones, filtros de eventos, estado activo/pausado y ajustes de entrega. Cada suscripción tiene un secreto de firma para que el receptor verifique que el payload viene de ReVend.
Ciclo de vida del secreto
Los secretos de firma se guardan mediante la capa cifrada de secretos externos. Crear y rotar muestran el texto plano una vez; después la plataforma usa la versión cifrada en servidor para firmar. Payloads, logs y metadata de actividad no deben convertirse en museo de secretos.
Entrega, retry y replay
El historial muestra intentos, respuestas, errores y próximos reintentos. Replay permite reenviar un evento cuando el sistema receptor ya se recuperó. Esto convierte "no llegó" en una investigación, no en una sesión de adivinanzas.