Regiones de API (EE. UU. y UE)

Esta página fue traducida automáticamente. Si encuentra errores o tiene sugerencias, contáctenos.

Una organización, una región

Rhombus opera dos regiones de producción independientes: EE. UU. y UE. Tu organización — sus usuarios, dispositivos, API keys y datos — vive exactamente en una de ellas. La región determina a qué hostnames se conecta tu integración; todo lo demás es idéntico, incluidas las rutas de los endpoints, los headers de autenticación, los formatos de solicitud y respuesta, y los límites de tasa.

Las API keys están vinculadas a la región. Una key generada en la Consola de la UE solo funciona contra endpoints de la UE, y una key de EE. UU. solo funciona contra endpoints de EE. UU. No hay redirección entre regiones — consulta Solución de problemas más abajo.

Endpoints regionales

Propósito	EE. UU.	UE
URL base de la API	`https://api2.rhombussystems.com`	`https://api2.eu.rhombussystems.com`
Media y streaming	`https://media.rhombussystems.com`	`https://media.eu.rhombussystems.com`
Consola de Rhombus	`https://console.rhombussystems.com`	`https://console.eu.rhombussystems.com`
Host de tokens OAuth	`https://auth-web.rhombussystems.com`	`https://auth-web.eu.rhombussystems.com`
WebSocket (STOMP)	`wss://ws.rhombussystems.com:8443/websocket`	`wss://ws.eu.rhombussystems.com:8443/websocket`
Especificación OpenAPI	`/api/openapi/public.json`	`/api/openapi/public.json`

El patrón es consistente en toda la plataforma: el hostname de la UE inserta .eu. después del subdominio — api2.rhombussystems.com se convierte en api2.eu.rhombussystems.com.

¿En qué región está tu organización?

Revisa la barra de direcciones cuando hayas iniciado sesión en la Consola de Rhombus:

console.rhombussystems.com — tu organización está en la región de EE. UU.
console.eu.rhombussystems.com — tu organización está en la región de la UE (la página de inicio de sesión también muestra la insignia EU).

Genera las API keys en la consola de tu propia región en Settings → API Management — por ejemplo, las organizaciones de la UE usan console.eu.rhombussystems.com/settings/api-management.

Llama a la API en tu región

Define la URL base una sola vez y todos los ejemplos de código de esta documentación funcionan para cualquiera de las dos regiones — las rutas, los headers y los payloads nunca cambian.

# Organizaciones de EE. UU.
BASE_URL="https://api2.rhombussystems.com"
# Organizaciones de la UE
# BASE_URL="https://api2.eu.rhombussystems.com"

curl -X POST "$BASE_URL/api/org/getOrganization" \
  -H "x-auth-scheme: api-token" \
  -H "x-auth-apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

import requests

# EE. UU.: "https://api2.rhombussystems.com"
# UE: "https://api2.eu.rhombussystems.com"
BASE_URL = "https://api2.rhombussystems.com"

response = requests.post(
    f"{BASE_URL}/api/org/getOrganization",
    headers={
        "x-auth-scheme": "api-token",
        "x-auth-apikey": "YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={},
)
response.raise_for_status()
print(response.json())

// EE. UU.: "https://api2.rhombussystems.com"
// UE: "https://api2.eu.rhombussystems.com"
const BASE_URL = "https://api2.rhombussystems.com";

const response = await fetch(`${BASE_URL}/api/org/getOrganization`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-auth-scheme": "api-token",
    "x-auth-apikey": "YOUR_API_KEY",
  },
  body: JSON.stringify({}),
});

console.log(await response.json());

Una llamada exitosa devuelve 200 OK con los detalles de tu organización. Un 403 Forbidden con "Invalid api key" generalmente significa que la key y la URL base pertenecen a regiones diferentes — consulta Solución de problemas.

SDKs generados

Cada región sirve la especificación OpenAPI en la misma ruta (/api/openapi/public.json). La entrada servers de la especificación actualmente solo lista la URL base de EE. UU., así que cuando generes un cliente para una organización de la UE, sobrescribe la URL base explícitamente:

Generar un cliente para la UE

openapi-generator-cli generate \
  -i https://api2.eu.rhombussystems.com/api/openapi/public.json \
  -g python \
  -o ./rhombus-python-client

# Luego apunta el cliente generado al host de la UE, p. ej.:
# configuration.host = "https://api2.eu.rhombussystems.com"

Rhombus CLI

La Rhombus CLI tiene soporte de regiones integrado. rhombus configure pregunta en qué región está tu organización con el prompt Region (us/eu) y deriva la URL del endpoint a partir de tu respuesta, y rhombus login usa automáticamente los hosts regionales correspondientes de inicio de sesión y de tokens. También puedes apuntar un solo comando — o todo tu entorno — directamente al endpoint de la UE:

Overrides de región en la CLI

# Por comando
rhombus camera get-minimal-camera-state-list \
  --endpoint-url https://api2.eu.rhombussystems.com

# Por sesión de shell
export RHOMBUS_ENDPOINT_URL=https://api2.eu.rhombussystems.com
rhombus camera get-minimal-camera-state-list

Conexiones OAuth y WebSocket

Los hostnames regionales aplican a toda la plataforma, no solo a la API REST:

Inicia sesión con Rhombus (OAuth) — los tres hosts del flujo OAuth (consola, auth-web, api2) cambian a sus equivalentes .eu. para las organizaciones de la UE. Las aplicaciones OAuth están vinculadas a la región igual que las API keys: registra, autoriza e intercambia tokens todo en la misma región.
Eventos en tiempo real por WebSocket — las organizaciones de la UE se conectan a wss://ws.eu.rhombussystems.com:8443/websocket. La autenticación y el protocolo STOMP son idénticos.

Residencia de datos

Las organizaciones aprovisionadas en la región de la UE están alojadas en la Unión Europea: su tráfico de API, almacenamiento de video y procesamiento en la nube permanecen dentro de la región.

Solución de problemas

`403 Invalid api key` — pero la key es correcta

Una solicitud al endpoint de la región equivocada falla con:

{
  "msg": "Invalid api key",
  "error": "Forbidden",
  "status": 403
}

Esta respuesta es idéntica tanto si la key es realmente inválida como si simplemente pertenece a la otra región — el error no incluye ninguna pista sobre la región. Si estás seguro de que la key es correcta, verifica en qué consola se generó (console. vs console.eu.) y asegúrate de que tu URL base coincida.

OAuth: “This application is not available for your organization”

Los clientId de OAuth están vinculados a la región. Si tu aplicación se registró en una región y un usuario intenta autorizarla a través de la consola de la otra región, la pantalla de consentimiento muestra This application is not available for your organization. Asegúrate de que la llamada de registro, la URL de autorización y el intercambio de tokens apunten a la misma región que la organización del usuario que inicia sesión.

Próximos pasos

Referencia de la API

Navega los 900+ endpoints — cada ruta funciona de forma idéntica en ambas regiones.

Rhombus CLI

Configura la CLI para tu región y explora la API desde tu terminal.

Eventos WebSocket

Transmite eventos en tiempo real desde el endpoint WebSocket de tu región.

Límites de tasa

Los mismos límites aplican en ambas regiones, y se aplican dentro de la región de tu organización.

Comenzar

Guías de implementación

Eventos en tiempo real

Una organización, una región

Endpoints regionales

¿En qué región está tu organización?

Llama a la API en tu región

SDKs generados

Rhombus CLI

Conexiones OAuth y WebSocket

Residencia de datos

Solución de problemas

`403 Invalid api key` — pero la key es correcta

OAuth: “This application is not available for your organization”

Próximos pasos

Referencia de la API

Rhombus CLI

Eventos WebSocket

Límites de tasa

​Una organización, una región

​Endpoints regionales

​¿En qué región está tu organización?

​Llama a la API en tu región

​SDKs generados

​Rhombus CLI

​Conexiones OAuth y WebSocket

​Residencia de datos

​Solución de problemas

​403 Invalid api key — pero la key es correcta

​OAuth: “This application is not available for your organization”

​Próximos pasos

Referencia de la API

Rhombus CLI

Eventos WebSocket

Límites de tasa

Una organización, una región

Endpoints regionales

¿En qué región está tu organización?

Llama a la API en tu región

SDKs generados

Rhombus CLI

Conexiones OAuth y WebSocket

Residencia de datos

Solución de problemas

`403 Invalid api key` — pero la key es correcta

OAuth: “This application is not available for your organization”

Próximos pasos