Ir al contenido

Rhombus Developers

Muestra video en vivo, abre puertas y reacciona a eventos desde tu aplicación.

Una API REST para las cámaras, el control de acceso, los sensores y el monitoreo de alarmas de Rhombus, con webhooks y eventos en tiempo real. Cada operación está documentada aquí y en una especificación OpenAPI 3.0.

¿Estás evaluando Rhombus para tu organización? Habla con ventas

  • Más de 1000 operaciones de API
  • OpenAPI 3.0
  • Webhooks y eventos por WebSocket
  • Regiones de EE. UU. y la UE

Empieza a construir

Encuentra tu camino

Inicio rápido

  1. Crea una clave de API

    En la Consola de Rhombus, ve a Configuración → Integraciones y recursos para desarrolladores → Tokens de API y haz clic en Agregar clave de API. Ponle un Nombre, deja el Tipo de autenticación en Token de API y elige un Rol: la clave puede hacer todo lo que el rol permite, así que empieza con uno de solo lectura. La clave se muestra una sola vez, así que cópiala ahora. Claves de API y certificados explica las claves de certificado (mTLS) y las demás credenciales.

  2. Realiza tu primera solicitud

    Lista las cámaras de tu organización. La clave va en dos encabezados, y casi todas las operaciones son un POST con un cuerpo JSON ({} cuando no reciben parámetros):

    bash
    curl -X POST "https://api2.rhombussystems.com/api/camera/getMinimalCameraStateList" \
      -H "x-auth-scheme: api-token" \
      -H "x-auth-apikey: $RHOMBUS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{}'

    La respuesta incluye una entrada por cámara:

    json
    {
      "error": false,
      "cameraStates": [
        {
          "uuid": "AAAAAAAAAAAAAAAAAAAAAA",
          "name": "Front Lobby",
          "locationUuid": "BBBBBBBBBBBBBBBBBBBBBB",
          "connectionStatus": "GREEN",
          "healthStatus": "GREEN"
        }
      ]
    }

    Revisa error además del código HTTP: algunos fallos devuelven 200 con "error": true y un errorMsg (Errores). Las organizaciones de la UE (consola en console.eu.rhombussystems.com) usan https://api2.eu.rhombussystems.com, y las claves solo funcionan en su propia región; consulta Regiones de API.

  3. Elige tu siguiente paso
  4. Pasa a producción

    Da a cada integración su propia clave con el rol más limitado que funcione (Permisos y rotación de claves), maneja los límites de tasa y consulta el Trust Center para la información de seguridad y cumplimiento.

Soporte