Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://api-docs.rhombus.community/llms.txt

Use this file to discover all available pages before exploring further.

Esta página fue traducida automáticamente. Si encuentra errores o tiene sugerencias, contáctenos.
La plataforma Rhombus expone un endpoint WebSocket para comunicación bidireccional en tiempo real entre tu aplicación y la consola de Rhombus. Esto te permite recibir notificaciones instantáneas sobre eventos de seguridad, alertas de políticas, cambios en dispositivos y otra actividad organizacional sin hacer polling a la API REST.

​
Cómo funciona

Las conexiones WebSocket de Rhombus utilizan el protocolo de mensajería STOMP 1.2 (Streaming Text Oriented Messaging Protocol) sobre una conexión WebSocket estándar. STOMP proporciona un protocolo simple basado en frames para suscribirse a tópicos y recibir mensajes estructurados. 
Your Application
      │
      ▼
  WebSocket (WSS)
      │
      ▼
  STOMP 1.2 Protocol
      │
      ▼
  Rhombus Event Bus ──► /topic/change/{orgUuid}

​
Endpoint de conexión

EntornoEndpoint
Producciónwss://ws.rhombussystems.com:8443/websocket

​
Conceptos clave

​
Tópicos

Una vez conectado, te suscribes a un tópico para recibir mensajes. El tópico principal para eventos organizacionales es: 
/topic/change/{orgUuid}
Este tópico emite eventos para todos los cambios dentro de tu organización, incluyendo alertas de políticas, actualizaciones de dispositivos y cambios de configuración.

​
Tipos de eventos

Cada mensaje en el tópico de cambios contiene una carga útil JSON con:
CampoDescripción
entityEl tipo de entidad que cambió (por ejemplo, POLICY_ALERT, DEVICE_CONFIG)
entityUuidIdentificador único de la entidad
typeEl tipo de cambio: CREATE, UPDATE o DELETE
deviceUuidUUID del dispositivo asociado (cuando aplica)
timestampMsTimestamp Unix en milisegundos

​
Autenticación

Las conexiones WebSocket se autentican usando únicamente tokens de API. La autenticación basada en certificados (mTLS) no es compatible con WebSocket. El token se pasa como un header HTTP durante el handshake de WebSocket.
Si actualmente te autenticas a la API REST de Rhombus mediante certificados, necesitarás un token de API separado para las conexiones WebSocket.

​
Cuándo usar WebSocket vs. la API REST

Caso de usoEnfoque recomendado
Reaccionar a alertas en tiempo realWebSocket
Construir un dashboard en vivoWebSocket
Disparar automatizaciones ante eventosWebSocket
Consultar datos históricosAPI REST
Administrar dispositivos o usuariosAPI REST
Recuperar clips de videoAPI REST (streaming DASH)

​
Qué sigue

Autenticación

Configura la autenticación con token de API para conexiones WebSocket.

Ciclo de vida de la conexión

Establece, mantén y cierra conexiones de forma adecuada.

Monitoreo de eventos

Suscríbete a tópicos y procesa eventos en tiempo real.

Ejemplos de código

Ejemplos completos y funcionales en Python, JavaScript y Go.
Last modified on April 30, 2026