RealityConnect API (RCAPI)
Introduction Vue d'ensemble de la RealityConnect API de Prevu3D : capacités, architecture régionale, authentification OAuth2 et intégration avec RealityPlatform et RealityTwin.
Premiers pas Prérequis, accès réseau et modèle de sécurité pour la RealityConnect API. Choisissez un flux OAuth et suivez son guide dédié.
Votre premier changement, de bout en bout Un parcours Client Credentials à copier-coller : obtenez un jeton, parcourez jusqu'à un site, renommez-le, voyez le changement dans la Prevu3D Platform, puis annulez-le.
Référence des scopes OAuth Chaque scope OAuth accordé par la RealityConnect API, ce qu'il autorise, et les pièges qui surprennent les nouvelles intégrations.
Rechercher des objets métier et des nœuds Recherchez dans les objets métier et les métadonnées d'un twin, ou dans la hiérarchie de nœuds de votre organisation, via l'API RealityConnect.
Flux OAuth Flux Client Credentials, Flux pour application native, Authorization Code + Custom Redirect Flow
Limites de débit Buckets de limite de débit de la RealityConnect API, en-têtes de réponse, et comment gérer les réponses 429 Too Many Requests.
Codes d'erreur Référence des codes d'erreur nommés renvoyés par les opérations de la RealityConnect API, par endpoint, avec la forme de la réponse et la gestion suggérée.
Ce que contextId accepte Les types d'id que le paramètre de chemin contextId accepte sur les routes twin et RealityPlan de la RealityConnect API, et pourquoi un id valide peut renvoyer 404.
Cycle de vie du jeton en pratique Comment mettre en cache et rafraîchir un jeton OAuth RealityConnect API en toute sécurité sur une intégration longue durée : TTL réels par flux et ce qui invalide un jeton avant l'heure.
Gestion des identifiants Comment stocker, faire pivoter et révoquer en toute sécurité les identifiants OAuth de l'API RealityConnect, et ce qu'un jeton d'accès compromis peut atteindre.
Ce que la suppression fait réellement, par ressource Référence de ce que fait la suppression de chaque ressource de la RealityConnect API : quelles suppressions sont récupérables, ce qui les bloque, et ce qu'il advient des références laissées derrière.
Types de nœuds et hiérarchie Les 10 types de nœuds de l'API RealityConnect, les combinaisons parent/enfant valides, les types que l'API peut créer, et la structure du DataNode.
Stabilité de l'API, versionnement et obsolescence Comment la RealityConnect API marque les opérations expérimentales, ce qui constitue un changement cassant, et la politique d'obsolescence.
Référence des icônes de POI (textureId) L'ensemble des valeurs textureId valides pour créer un point d'intérêt (POI), et ce que chaque icône représente réellement.
Trouver vos IDs : organisations, nœuds et contexte Découvrez votre ID d'organisation, parcourez l'arborescence de nœuds de l'API RealityConnect, et l'ID attendu par chaque famille de routes.
Référence : téléversement multipart partagé Le schéma initier, téléverser, finaliser partagé par les endpoints de téléversement de la RealityConnect API, avec la règle partNumber vs startIndex pour la numérotation des parties.
Valeurs de métadonnées typées et pièces jointes Référence des valeurs de propriétés de métadonnées de l'API RealityConnect : l'union string/nombre/booléen/objet tagué, les types sentinelles external-link et attachment, et le flux d'upload, téléchargement et suppression des pièces jointes.
Miniatures de nœud Téléverser, récupérer et supprimer l'image miniature d'un nœud de données, et le comportement d'includeThumbnail et thumbnailSignedUrl sur browse et search.
Exigences réseau Exigences de pare-feu, de proxy, de TLS et de sortie (egress) pour accéder à la RealityConnect API depuis un réseau d'entreprise, avec une séquence de diagnostic de connectivité étape par étape.
RealityConnect API FAQ Réponses aux questions commerciales, architecturales et « puis-je faire ça » sur la RealityConnect API qui reviennent avant même l'approbation d'un projet.