> ## Índice de la documentación
> Consulta el índice completo de la documentación en: https://developer.rhombus.com/llms.txt
> Úsalo para descubrir todas las páginas disponibles antes de seguir explorando.

# Introducción

> Integra las cámaras, el control de acceso, los sensores y el monitoreo de alarmas de Rhombus con tus sistemas mediante la API REST, los webhooks y los eventos WebSocket en tiempo real de Rhombus.

> **Note**: Esta página se tradujo automáticamente. Si encuentras errores o tienes sugerencias, [escríbenos](mailto:support@rhombus.com).

## Inicio rápido

1. **Crea una clave de API**

   En la [Consola de Rhombus](https://console.rhombussystems.com/settings/integrations/api-tokens/), 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](https://developer.rhombus.com/es/authentication/api-keys) 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
   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 '{}'
   ```

   ```javascript JavaScript
   const res = await fetch("https://api2.rhombussystems.com/api/camera/getMinimalCameraStateList", {
     method: "POST",
     headers: {
       "x-auth-scheme": "api-token",
       "x-auth-apikey": process.env.RHOMBUS_API_KEY,
       "Content-Type": "application/json",
     },
     body: "{}",
   });
   const { cameraStates } = await res.json();
   console.log(`${cameraStates.length} cámaras`);
   ```

   ```python Python
   import os
   import requests

   res = requests.post(
       "https://api2.rhombussystems.com/api/camera/getMinimalCameraStateList",
       headers={
           "x-auth-scheme": "api-token",
           "x-auth-apikey": os.environ["RHOMBUS_API_KEY"],
       },
       json={},
   )
   print(f"{len(res.json()['cameraStates'])} cámaras")
   ```

   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](https://developer.rhombus.com/es/errors)). 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](https://developer.rhombus.com/es/api-regions).

3. **Elige tu siguiente paso**

   - **Mostrar video o instantáneas en un navegador o una app:** [Tokens federados](https://developer.rhombus.com/es/authentication/federated-tokens) y [Streaming de video](https://developer.rhombus.com/es/implementations/streaming-video).
   - **Reaccionar a alertas, eventos de puertas y cambios de dispositivos:** [Webhooks](https://developer.rhombus.com/es/webhooks) o el [WebSocket](https://developer.rhombus.com/es/websocket/overview).
   - **Encontrar la operación que necesitas:** la [referencia de la API](https://developer.rhombus.com/api-reference/overview) (en inglés), agrupada por producto.
   - **Generar un cliente o conectar una herramienta de IA:** [Herramientas y SDKs](https://developer.rhombus.com/es/resources).

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](https://developer.rhombus.com/es/authentication/permissions)), maneja los [límites de tasa](https://developer.rhombus.com/es/rate-limits) y consulta el [Trust Center](https://www.rhombus.com/trust/) para la información de seguridad y cumplimiento.

## Soporte

- **[Soporte de Rhombus](mailto:support@rhombus.com)**: Contacta al Soporte de Rhombus por correo electrónico para obtener ayuda con tu integración.
- **[Base de conocimientos](https://support.rhombussystems.com/hc/en-us)**: Artículos de configuración y administración de los productos de Rhombus (en inglés).
- **[Estado del sistema](https://status.rhombus.com/)**: Disponibilidad actual e historial de incidentes de los servicios de Rhombus.
- **[Trust Center](https://www.rhombus.com/trust/)**: Información sobre seguridad, privacidad de datos y cumplimiento.