RealityConnect API FAQ

Algunas preguntas no pertenecen a ninguna página de referencia en concreto: son comerciales, arquitectónicas, o tratan sobre lo que la API no hace. Esta página reúne las que surgen con más frecuencia en soporte, ingeniería de soluciones y conversaciones comerciales, antes de escribir una sola línea de código.

¿Puedo acceder a más de una organización con un mismo conjunto de credenciales?

No, por diseño. Cada token OAuth está limitado de forma permanente a la organización para la que fue emitido: no hay manera de cambiar de organización ni de leer entre organizaciones con un mismo conjunto de credenciales. Consulta la Introducción y el Resumen de capacidades para tener el panorama completo de lo que la API puede y no puede hacer.

¿Por qué mi lista aparece vacía si mi token tiene todos los ámbitos?

Revisa el acceso al contenido y el rol, no los ámbitos. Los ámbitos de OAuth son solo la capa 1 del modelo de seguridad: un token con todos los ámbitos sigue viendo únicamente los nodos a los que la cuenta llamante tiene acceso de contenido, y solo puede actuar dentro del rol que tiene asignado ahí. Un resultado vacío casi siempre indica un problema de capa 2 o 3, no un ámbito faltante. Ámbitos de OAuth por tarea confirma si al menos tienes los ámbitos correctos; a partir de ahí, revisa el acceso al contenido y el rol de la cuenta llamante en ese nodo.

¿Cómo encuentro la región de mi organización?

Llama a GET /oauth/api-info con tu token de acceso: la respuesta incluye tu apiUrl regional y tu organization.id. Nunca codifiques de forma fija una URL regional. Consulta Primeros pasos y el Flujo de Client Credentials para ver un ejemplo completo.

¿Puedo usar la API sin una licencia de RealityTwin ni un puesto de RealityPlan?

En su mayor parte, sí. Una licencia de RealityTwin Data Manager solo se consume con llamadas que tocan contenido de un twin: activos, POI, zonas, borradores, búsqueda, metadatos de objetos, sesiones de embed y la biblioteca de activos. La gestión de usuarios e invitaciones, los roles y la llamada de detección /oauth/api-info no tocan ningún twin y no consumen licencia. Algunos endpoints relacionados con RealityPlan también consumen un puesto de RealityPlan. Consulta Licencias.

¿Existe un entorno de prueba o sandbox?

Hoy no existe un entorno de sandbox o de prueba dedicado. La forma más sencilla de probar la API es crear una aplicación Client Credentials en tu propia organización; consulta Elige un flujo OAuth.

¿Cómo conservo los identificadores de mi sistema en los objetos de Prevu3D?

No existe un campo reservado para esto: usa una propiedad simple de tipo cadena o número en los metadatos del objeto, por ejemplo una sección llamada “External IDs” que contenga el identificador de tu sistema. Los metadatos son datos libres de clave/valor, no un esquema fijo, así que cualquier nombre de propiedad funciona sin aprovisionar nada de antemano. Consulta Valores de metadatos tipados y archivos adjuntos.

¿Qué sigue?

Resumen de capacidades para saber qué puede leer y escribir la API, y qué no hace en absoluto.
Primeros pasos para el modelo de seguridad, las licencias y cómo elegir un flujo OAuth.
Explora la referencia de la API para ver el catálogo completo de endpoints.