RealityConnect API (RCAPI)

Introducción Descripción general de la API RealityConnect de Prevu3D: capacidades, arquitectura regional, autenticación OAuth2 y cómo encaja en las integraciones de RealityPlatform y RealityTwin.

Primeros pasos Requisitos previos, acceso de red y el modelo de seguridad de la API de RealityConnect. Elige un flujo OAuth y sigue su guía dedicada.

Tu primer cambio, de principio a fin Un recorrido de Client Credentials para copiar y pegar: obtén un token, navega hasta un sitio, renómbralo, ve el cambio en la Prevu3D Platform y deshazlo.

Referencia de ámbitos de OAuth Todos los ámbitos de OAuth que otorga la API de RealityConnect, lo que autorizan y los detalles que suelen sorprender a integraciones nuevas.

Búsqueda de objetos de negocio y nodos Busca dentro de los objetos de negocio y los metadatos de un twin, o busca en la jerarquía de nodos de tu organización, mediante la API de RealityConnect.

Flujos OAuth Flujo de Client Credentials, Flujo de aplicación nativa y Flujo de Authorization Code + redireccionamiento personalizado

Límites de tasa Los buckets de límite de tasa de la API de RealityConnect, las cabeceras de respuesta y cómo gestionar el error 429 Too Many Requests.

Códigos de error Referencia de los códigos de error con nombre de la API de RealityConnect, agrupados por endpoint, con la forma de la respuesta y el manejo sugerido.

Qué acepta contextId Qué tipos de id acepta el parámetro de ruta contextId en las rutas de twin y RealityPlan de la RealityConnect API, y por qué un id válido puede devolver 404.

Ciclo de vida del token en la práctica Cómo almacenar en caché y renovar un token OAuth de la RealityConnect API de forma segura en una integración de larga duración: TTL reales por flujo y qué invalida un token antes de tiempo.

Gestión de credenciales Cómo almacenar, rotar y revocar de forma segura las credenciales OAuth de la API de RealityConnect, y qué puede alcanzar un token de acceso filtrado.

Qué hace realmente eliminar, por recurso Referencia de lo que hace eliminar cada recurso de la RealityConnect API: qué eliminaciones son recuperables, qué las bloquea y qué ocurre con las referencias que quedan.

Tipos de nodo y jerarquía Los 10 tipos de nodo de la API de RealityConnect, qué combinaciones padre/hijo son válidas, qué tipos puede crear la API y la estructura del DataNode.

Estabilidad, versionado y obsolescencia de la API Cómo la RealityConnect API marca las operaciones experimentales, qué se considera un cambio disruptivo, y la política de obsolescencia.

Referencia de iconos de POI (textureId) El conjunto completo de valores válidos de textureId para crear un punto de interés (POI), y lo que representa realmente cada icono.

Cómo encontrar tus IDs: organizaciones, nodos y contexto Descubre tu ID de organización, recorre el árbol de nodos de la API de RealityConnect y qué ID (contextId, organizationId) espera cada familia de rutas.

Referencia: subida multiparte compartida El patrón iniciar, subir y finalizar compartido por los endpoints de subida de la API de RealityConnect, incluida la regla partNumber frente a startIndex.

Valores de metadatos tipados y archivos adjuntos Referencia de los valores de propiedades de metadatos de la API de RealityConnect: la unión string/número/booleano/objeto etiquetado, los tipos centinela external-link y attachment, y el flujo de subida, descarga y eliminación de adjuntos.

Miniaturas de nodo Sube, recupera y elimina la imagen de miniatura de un nodo de datos, y cómo se comportan includeThumbnail y thumbnailSignedUrl en browse y search.

Requisitos de red Requisitos de firewall, proxy, TLS y salida (egress) para conectar con la RealityConnect API desde una red corporativa, además de una secuencia de diagnóstico de conectividad paso a paso.

RealityConnect API FAQ Respuestas a las preguntas comerciales, arquitectónicas y de '¿puedo hacer esto?' sobre la RealityConnect API que surgen antes de aprobar un proyecto.