Appearance
Orbit_ es la plataforma de eventos en tiempo real de Sushell: te permite suscribir tus endpoints a eventos del ecosistema, recibir webhooks garantizados y consumir colas pub/sub de alta velocidad.
¿Cómo accedo a Orbit_?
Con tu cuenta Sushell. Entra a tu panel con el usuario habitual y abir el módulo Orbit_ desde ahí: forma parte del mismo ecosistema y no se contrata por separado.
¿Qué puede hacer Orbit_?
- Webhooks: recibe eventos en tu servidor con estrategia at-least-once y reintentos automáticos.
- Streaming de datos: consume flujos de eventos en tiempo real de tus productos (por ejemplo transacciones de FELvus).
- Colas pub/sub: desacopla tus sistemas publicando y suscribiéndote a tópicos de alta velocidad.
Verificación de firma (HMAC SHA256)
Cada webhook de Orbit_ incluye un encabezado de firma para que puedas validar su autenticidad:
javascript
const crypto = require('crypto');
function verifyOrbitSignature(payload, headerSignature, secret) {
const expected = crypto.createHmac('sha256', secret).update(payload).digest('hex');
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(headerSignature));
}Tips para una integración confiable
- Responde rápido: confirma la recepción del webhook antes de procesar la lógica pesada.
- Haz tu handler idempotente: con la estrategia at-least-once un mismo evento puede llegar más de una vez.
- Registra los intentos fallidos: Orbit_ reintenta según una política de retrasos; revisa los logs para detectar problemas de tu endpoint.
Ejemplo práctico
"Mi tienda quiere reaccionar al instante cuando se emite una factura en FELvus."
Suscribes tu endpoint al evento de certificación de FELvus en Orbit_, verificas la firma HMAC y disparas la lógica de tu inventario o notificaciones en tiempo real.