Registro de cambios

Un modelo de autenticación en todos los hosts

Todos los hosts de la API de Rhombus (api2, los hosts de medios y el WebSocket de eventos) aceptan las mismas credenciales y responden igual a los errores de autenticación. Autenticación describe el modelo.

Cambios incompatibles

401 para problemas de credenciales, 403 para permisos — Una credencial ausente, inválida, vencida o revocada recibe 401; una credencial válida sin permiso recibe 403. Ambas llevan el cuerpo de error estándar, con un errorCode como INVALID_CREDENTIAL o PERMISSION_REQUIRED y un txid. Si tu código trata 403 como una clave incorrecta, maneja también 401.

Los tokens federados duran como máximo 24 horas — durationSec es de 1 hora por defecto y tiene un límite de 24 horas, y la respuesta agrega expiresAtMs. Un token generado con domain solo funciona desde ese origen, así que domain debe ser un origen absoluto como https://app.example.com. Un token federado no puede generar otro, y termina cuando se elimina o revoca la credencial que lo generó. Tokens federados

Las llamadas de partners necesitan x-auth-org — Fuera de los endpoints de partners, una credencial de partner sin x-auth-org recibe los encabezados Deprecation y Sunset: Tue, 05 Jan 2027 00:00:00 GMT y deja de funcionar en esa fecha. El WebSocket de eventos ya lo exige. Llamadas a la API de partners

Eventos de alertas de políticas — Las alertas de políticas del WebSocket de eventos se filtran según el rol del suscriptor, y targetUsers y targetRoles son cadenas UUID. Referencia de eventos

Se eliminaron las restricciones de IP por clave — Las claves de API ya no tienen restrictToAllowedIps, y getApiTokens ya no lo devuelve. Las claves ahora informan expiresAtMs, y parentTokenUuid u oauthGrant cuando otra clave o una autorización de OAuth las creó.

Nuevas funciones

OAuth en todos los hosts, con scopes — Envía los access tokens de OAuth como Authorization: Bearer en api2, los hosts de medios y el WebSocket de eventos. Las apps solicitan los scopes read, write y physical, y los refresh tokens rotan en cada uso. OAuth

Ciclo de vida de las claves de API — Crea claves con vencimiento, rótalas con un periodo de superposición y renueva certificados con la API: submitApiTokenApplication, rotateApiToken y renewApiTokenCert, con sus versiones de partner en /api/partner/. Claves de API

Revocar un token federado — POST /api/org/revokeFederatedSessionToken termina un token antes de tiempo, por ejemplo cuando tu usuario cierra sesión. Tokens federados

Firmas de webhooks SHA-256 — Los webhooks llevan x-rhombus-signature-sha256, un HMAC-SHA256 del cuerpo sin procesar. Webhooks

Los manifiestos de streaming llevan su autenticación — Los manifiestos DASH y las listas HLS de clips de alertas agregan la consulta federada o de enlace compartido a cada URL de segmento, así que una sola URL de manifiesto funciona en cualquier reproductor. Autenticación de medios

CLI y servidor MCP — rhombus login inicia sesión con OAuth y acepta --region us|eu. El servidor MCP actúa en la organización cliente de un partner con x-auth-org o RHOMBUS_PARTNER_ORG. Rhombus CLI, Rhombus MCP

Actualizaciones

Revocación en 60 segundos — Eliminar una clave, cambiar su rol o revocar una autorización de OAuth tiene efecto en 60 segundos en todos los hosts, y los WebSockets abiertos se cierran con el código 1008.

Límites de tasa — Los tokens federados y OAuth de partners cuentan para el límite de tasa de tu organización, y un 429 es JSON con RATE_LIMITED y Retry-After. Límites de tasa

Certificados — Los nuevos certificados de desarrollador y de partner duran 1 año, y una solicitud de firma de certificado debe estar firmada por su propia clave.

Referencia de la API — Todas las operaciones incluyen el encabezado x-auth-org, y GET /api/oauth/authorize incluye scope. El submitApiTokenApplication obsoleto, anterior a la ruta /org/, ya no está en la referencia porque las credenciales de API no pueden llamarlo; usa /api/integrations/org/submitApiTokenApplication.

Claves de reclamación — ClaimKeyExpirationEmailStateEnum agrega SEVEN_DAY_EMAIL_SUCCEEDED y SEVEN_DAY_EMAIL_FAILED. Trata los valores que no reconozcas.

Streaming por LAN documentado

Nuevas funciones

Streaming por LAN — Una nueva guía cubre la transmisión de video en vivo, grabaciones y audio bidireccional directamente desde cámaras y gateways de audio de tu red local. Los dispositivos de tu LAN nunca aceptan claves de API: generas un token federado de corta duración, limitado a un dispositivo, con POST /api/org/generateFederatedSessionToken y lo envías como x-auth-scheme: federated-token + x-auth-ft, como encabezados o parámetros de consulta. La guía también cubre los formatos de URI LAN, el formato del WebSocket de audio, las limitaciones de los navegadores y la solución de problemas.

API tokens vs tokens federados — La guía de inicio rápido ahora explica en qué se diferencian ambas credenciales y dónde funciona cada una.

Leer la guía

Verificación de firmas de webhooks — La página de Webhooks ahora documenta los encabezados x-rhombus-signature-sha1 y x-rhombus-signature-sha256, dónde encontrar el secreto de cada webhook y código de verificación para Python y Node.js. Más información

Cuentas partner en Iniciar sesión con Rhombus — Los usuarios partner pueden completar el flujo OAuth y emitir claves de API de partner con el esquema partner-api-oauth-token. Más información

Actualizaciones

Correcciones — Las conexiones WebSocket de partner envían x-auth-org como encabezado, no como parámetro de consulta, y el handshake ya no necesita una sesión previa. Las rutas de la consola para crear claves de API coinciden con la Consola de Rhombus actual. El endpoint de eventos de conteo de personas más recientes se eliminó de la API y ya no está documentado; usa getCountReportV2 o getOccupancyCountsV2 en su lugar.

Actualizado: 2026-10-21

Regiones de API de EE. UU. y la UE documentadas

Rhombus opera dos regiones de producción independientes — EE. UU. y UE — y la documentación ahora cubre ambas.

Nuevas funciones

Guía de regiones de API — Una nueva guía de Regiones de API (EE. UU. y UE) cubre el mapa completo de endpoints regionales (api2.eu.rhombussystems.com, media.eu.rhombussystems.com, console.eu.rhombussystems.com, auth-web.eu.rhombussystems.com, wss://ws.eu.rhombussystems.com:8443/websocket), cómo saber en qué región está tu organización, las claves de API vinculadas a la región y la solución de problemas entre regiones — incluido por qué una llamada a la región equivocada devuelve 403 Invalid api key.

Endpoints de la UE en toda la documentación — El inicio rápido, la vista general de la referencia de la API, la guía de OAuth, la guía de partners, las páginas de WebSocket, los límites de tasa y la documentación de la CLI ahora muestran los hosts de ambas regiones. La definición AsyncAPI de WebSocket ganó una entrada de servidor production-eu.

Soporte de regiones de la Rhombus CLI documentado — rhombus configure solicita una región (us/eu) y deriva el endpoint automáticamente; rhombus login usa los hosts regionales correspondientes de inicio de sesión y de tokens. Antes no estaba documentado.

Lee la guía

Actualizado: 2026-08-03

EdgeCaster: latencia sub-segundo, streams ilimitados y autorrecuperación 24/7

La puerta de enlace RTSP EdgeCaster recibió una actualización importante centrada en la eficiencia y la latencia inferior a un segundo.

Mejoras

Latencia inferior a un segundo — La canalización de stream copy (sin transcodificación) se reajustó para eliminar el buffering en cada salto: FFmpeg se ejecuta sin buffering de entrada, con flags de baja latencia, arranque rápido y retardo de multiplexación en cero, mientras que MediaMTX descarta rápidamente los publicadores congelados. EdgeCaster siempre envía el fotograma más reciente con menos de un segundo de latencia añadida dentro del dispositivo; la latencia de extremo a extremo también depende del intervalo de keyframes de la cámara y del búfer propio de tu sistema consumidor.

Streams concurrentes ilimitados — El límite anterior de 10 streams desapareció. Los streams no tienen tope de forma predeterminada (max_streams: 0); el dispositivo ejecuta tantos como permitan su red y su CPU. Las pruebas reales en una Raspberry Pi 5 mostraron varios streams 1080p más múltiples lectores RTSP con aproximadamente un 3% de CPU.

Autorrecuperación 24/7 — La detección de congelamiento a nivel de fotograma identifica en segundos los feeds congelados pero vivos y los recupera mediante un único relanzamiento controlado con una URL de Secure Raw Stream nueva. Reintentos rápidos, luego un backoff de 5 minutos — nunca se rinde de forma permanente.

Instalación más sencilla — Un instalador de una línea para cualquier máquina Ubuntu/Debian (arm64, amd64 o armv7) y una imagen de Raspberry Pi lista para grabar. Las instalaciones manuales por checkout de git ahora también reciben actualizaciones automáticas nocturnas.

Panel rediseñado y adaptado a móviles — Una consola de operador más limpia y adaptable que funciona en cualquier dispositivo o navegador.

Nuevas funciones

Panel de salud en vivo — Métricas en tiempo real por Server-Sent Events (~1s): streams activos, CPU, memoria, temperatura, estado de energía/throttling, promedio de carga, tiempo de actividad, y rendimiento y conteo de lectores por stream. Las métricas de temperatura y energía de la Pi requieren el kernel linux-raspi.

Alertas por webhook — Alertas de stream caído, bajo voltaje, throttling térmico y CPU/carga alta sostenida hacia Slack, Make.com o cualquier listener HTTP, con umbrales configurables, periodos de enfriamiento por alerta y limpieza al recuperarse. Configúralas en Settings → Alerts, que incluye un botón de alerta de prueba.

Visor de logs en vivo — Transmite los logs de Application, Streams y Rhombus API en vivo desde el panel en una consola estilo terminal — sin necesidad de SSH.

Acceso público seguro con un clic — Accede al panel desde cualquier lugar mediante un túnel rápido de Cloudflare (no se requiere cuenta de Cloudflare), protegido por usuario y contraseña. El acceso desde la LAN sigue sin requerir inicio de sesión; el enlace público es efímero y cambia cada vez que el acceso público se reinicia, y RTSP nunca se tuneliza.

Lee la guía

Actualizado: 2026-07-10

Nuevas guías de implementación y una revisión completa de precisión

Nuevas funciones

Control de acceso — Una guía completa de la API de control de acceso: listar y administrar puertas con control de acceso, desbloqueo remoto, credenciales Wiegand, grupos y concesiones de acceso, horarios semanales y planes de bloqueo. Lee la guía

Reconocimiento de matrículas (LPR) y vehículos — Consulta eventos de detección de LPR, busca matrículas (incluida la coincidencia aproximada), crea listas de vigilancia de vehículos con indicadores de alerta y confianza, etiqueta vehículos y exporta detecciones. Lee la guía

Reconocimiento facial y conteo de personas — Registra y administra personas conocidas, sube imágenes de rostros para la coincidencia, consulta eventos de coincidencia facial, ajusta el umbral de confianza de coincidencia y obtén analíticas de conteo de personas de las cámaras. Lee la guía

Informes y analíticas — Genera informes de conteo y series temporales, lee conteos de ocupación y de cruce de líneas, trabaja con los enums de tipo/intervalo/alcance de informe y exporta los datos de informes como CSV. Lee la guía

Actualizaciones

Revisión de precisión de la documentación — Cada guía se revisó contra la API de producción y se corrigió en cuanto a rutas de endpoints, campos de solicitud y respuesta, encabezados de autenticación y payloads de eventos. Entre las correcciones destacadas se incluyen el flujo de OAuth 2.0 de "Iniciar sesión con Rhombus", la estructura del payload de entrega de webhooks y el esquema de eventos de WebSocket.

Actualizado: 2026-07-08

Documentación de la API para partners

Nuevas funciones

Partner API Calls — Una nueva guía para proveedores de servicios administrados y revendedores que explica cómo realizar llamadas a la API como partner: autenticarse con una clave de API de partner, administrar organizaciones de clientes con endpoints de partner y delimitar las llamadas a nivel de cliente a una organización administrada mediante el encabezado x-auth-org. Lee la guía

Actualizado: 2026-06-29

Herramientas e integraciones para desarrolladores

Nuevas funciones

Rhombus CLI — Una herramienta de línea de comandos para administrar todo tu despliegue de Rhombus desde la terminal. Admite más de 60 categorías de recursos de la API, unión de video, análisis de fotogramas, monitoreo de alertas en tiempo real y chat impulsado por IA. Disponible vía Homebrew, script de shell o desde el código fuente. Lee la guía

React SDK — El paquete oficial @rhombussystems/react ofrece componentes listos para integrar transmisiones de cámaras de Rhombus en tus aplicaciones React. Incluye tanto un reproductor DASH con búfer como un reproductor H.264 en tiempo real por WebSocket. Lee la guía

Rhombus API MCP Server — Un servidor MCP que da a herramientas de IA como Claude, Cursor y otras acceso directo a tus cámaras, control de acceso, sensores y toda la plataforma Rhombus. Admite más de 30 herramientas en todos los tipos de recursos principales. Lee la guía

Claude Code Plugins — Skills, agentes y hooks listos para usar en Claude Code, organizados por perfil (desarrollador, usuario, partner). Instálalos desde el Rhombus Claude Code Plugin Marketplace. Lee la guía

EdgeCaster RTSP Gateway — Una pasarela de borde basada en Raspberry Pi que convierte las transmisiones seguras de cámaras de Rhombus a RTSP para sistemas VMS, NVR y de video de terceros heredados. Lee la guía

Nodo oficial de la comunidad de n8n — El paquete @rhombussystems/n8n-nodes-client ofrece acceso nativo a Rhombus en n8n con 6 tipos de recursos y 19 operaciones, sin necesidad de configurar HTTP en crudo. Lee la guía

Autenticación OAuth 2.0 — Ahora puedes autenticar a los usuarios de Rhombus en tu aplicación usando OAuth 2.0 con PKCE ("Iniciar sesión con Rhombus"). Lee la guía

SAML SSO y aprovisionamiento SCIM — Configura programáticamente el inicio de sesión único SAML y el aprovisionamiento de usuarios SCIM para tu organización de Rhombus, con soporte para Okta, Azure AD, Google Workspace y OneLogin. Lee la guía

Actualizaciones

Navegación de la referencia de la API — La barra lateral de la referencia de la API ahora organiza más de 800 endpoints en 7 grupos colapsables (Cameras & Video, Access Control, Security & Alerts, IoT Sensors, Organization & Users, Integrations, Devices & System) para una navegación más rápida.

Guía de límites de tasa — Nueva documentación que explica cómo funciona la limitación de tasa de la API de Rhombus, incluyendo estrategias de reintento y ejemplos de código. Lee la guía

Documentación de WebSocket — Reescritura completa de las guías de transmisión de eventos en tiempo real, que cubre la autenticación, el ciclo de vida de la conexión, el protocolo STOMP, el monitoreo de eventos y la resolución de problemas. Lee las guías

Guías de implementación mejoradas — Las guías de monitoreo de alarmas y sensores IoT ahora incluyen flujos de trabajo completos de la API con ejemplos de código en varios lenguajes.

Actualizado: 2026-04-20

Expansión importante de la API

La API de Rhombus se ha actualizado con 29 nuevos endpoints agregados en 2 nuevas categorías de servicio.

Nuevos endpoints

Relay (24 endpoints):

• Administración de NVR: detalles, estado, tiempo de actividad, reinicio, anulación de registro, actualizaciones de firmware
• Integración de cámaras de terceros: asignar, autenticar, descubrir, administrar contraseñas, endpoints RTSP
• Controles PTZ: movimiento y estado

Access Control Integrations (4 endpoints):

• Integración con Boulevard: crear, leer, actualizar, eliminar y prueba de conexión

Nuevas categorías de servicio

• Relay Webservice

Versión de la API: 1.0 Actualizado: 2026-04-02

Nuevos endpoints de la API

La API de Rhombus se ha actualizado con 2 nuevos endpoints agregados.

Nuevos endpoints

Component:

• POST /api/component/findPaginatedComponentEventsByAccessControlledDoor - Recupera todos los eventos de componentes relevantes para el AccessControlledDoor especificado

Report:

• POST /api/report/getOccupancyCountsV2 - Obtiene los conteos de ocupación V2

Versión de la API: 1.0 Actualizado: 2026-03-07

Nuevos endpoints de la API

La API de Rhombus se ha actualizado con 2 nuevos endpoints agregados.

Nuevos endpoints

Report:

• POST /api/report/getBatchThresholdCrossingCountReport - Obtiene el reporte por lotes de conteo de cruces de umbral
• POST /api/report/getThresholdCrossingCountReportForOrg - Obtiene el reporte por lotes de conteo de cruces de umbral para toda la organización

Versión de la API: 1.0 Actualizado: 2026-02-10

Nuevos endpoints de la API

La API de Rhombus se ha actualizado con 5 nuevos endpoints agregados.

Nuevos endpoints

Elevator:

• POST /api/component/elevator/addAccessControlledElevatorLandingLabel - Crea una etiqueta que puede asignarse a un rellano de ascensor con control de acceso
• POST /api/component/elevator/findAccessControlledElevatorLandingShadows - Encuentra los shadows de rellanos de ascensor con control de acceso dentro de la organización
• POST /api/component/elevator/findAccessControlledElevatorLandingShadowsByLocation - Encuentra los shadows de rellanos de ascensor con control de acceso dentro de la ubicación especificada
• POST /api/component/elevator/getAccessControlledElevatorLandingLabelsForOrg - Obtiene todas las etiquetas de rellanos de ascensor con control de acceso de la organización
• POST /api/component/elevator/removeAccessControlledElevatorLandingLabel - Elimina una etiqueta de un rellano de ascensor con control de acceso

Versión de la API: 1.0 Actualizado: 2026-01-30

Reestructuración de la navegación de la documentación

Reorganizamos la documentación en grupos de navegación basados en temas para facilitar el descubrimiento.

• Guías: Primeros pasos, guías de implementación para cámaras, control de acceso, monitoreo de alarmas, sensores IoT y más
• Integraciones: Plataformas de low-code/no-code (Zapier, Make.com, N8N) e integración de herramientas de IA vía MCP
• Referencia de la API: Referencia completa de la API REST con pruebas de endpoints en vivo, autogenerada a partir de la especificación OpenAPI

Todos los enlaces existentes siguen funcionando: no hay cambios incompatibles en el contenido ni en las URLs.

Nuevos endpoints de la API

La API de Rhombus se ha actualizado con 2 nuevos endpoints agregados.

Nuevos endpoints

Alert Monitoring:

• POST /api/alertmonitoring/disableMonitoringForLocation - Deshabilita el monitoreo para una ubicación
• POST /api/alertmonitoring/enableMonitoringForLocation - Habilita el monitoreo para una ubicación

Lanzamiento de la nueva documentación

Rediseño completo de la documentación para desarrolladores de Rhombus.

• Nueva plataforma: Búsqueda mejorada, modo oscuro y soporte móvil
• Navegación de 3 pestañas: Guías, Integraciones y Referencia de la API para una separación clara del contenido
• Playground interactivo de la API: Pruebas de endpoints en vivo directamente en la documentación
• Sincronización nocturna: Una canalización automatizada mantiene la documentación de la API al día con producción
• Lista para IA: Integración de servidor MCP, archivos de contexto llms.txt y especificación OpenAPI descargable

Escribe a support@rhombus.com para compartir comentarios o solicitar contenido nuevo.