RealityConnect API (RCAPI)
Einführung Überblick über die Prevu3D RealityConnect API: Funktionen, regionale Architektur, OAuth2-Authentifizierung und Integration mit RealityPlatform und RealityTwin.
Erste Schritte Voraussetzungen, Netzwerkzugriff und Sicherheitsmodell für die RealityConnect API. Wählen Sie einen OAuth-Flow und folgen Sie dem zugehörigen Leitfaden.
Ihre erste Änderung, von Anfang bis Ende Ein zum Kopieren geeigneter Client-Credentials-Durchlauf: Token abrufen, zu einer Site navigieren, sie umbenennen, die Änderung in der Prevu3D Platform sehen und dann rückgängig machen.
OAuth-Scopes-Referenz Jeder OAuth-Scope, den die RealityConnect API vergibt, was er autorisiert, und die Stolperfallen für neue Integrationen.
Business-Objekte und Knoten durchsuchen Durchsuchen Sie die Geschäftsobjekte und Metadaten eines Twins oder die Knotenhierarchie Ihrer Organisation über die RealityConnect API.
OAuth-Flows Client-Credentials-Flow, Native-Anwendungsflow und Authorization Code + Custom Redirect Flow
Rate Limits RealityConnect API Rate-Limit-Buckets, Antwort-Header und der Umgang mit 429 Too Many Requests.
Fehlercodes Referenz der benannten Fehlercodes der RealityConnect API nach Endpunkt, mit Antwortformat und empfohlener Behandlung.
Was contextId akzeptiert Welche Id-Typen der Pfadparameter contextId auf RealityConnect API Twin- und RealityPlan-Routen akzeptiert, und warum eine gültige Id trotzdem 404 zurückgeben kann.
Token-Lifecycle in der Praxis So cachen und aktualisieren Sie einen RealityConnect API OAuth-Token sicher über eine langlaufende Integration hinweg: reale TTLs je Flow und was einen Token vorzeitig ungültig macht.
Umgang mit Zugangsdaten So speichern, rotieren und widerrufen Sie RealityConnect-API-OAuth-Zugangsdaten sicher – und was ein geleakter Access Token erreichen kann.
Was Löschen wirklich bedeutet, je Ressource Referenz dazu, was das Löschen jeder RealityConnect-API-Ressource bewirkt: welche Löschvorgänge wiederherstellbar sind, was sie blockiert und was mit zurückbleibenden Verweisen passiert.
Knotentypen und Hierarchie Die 10 Knotentypen der RealityConnect API, gültige Eltern-Kind-Kombinationen, welche Typen die API erstellen kann, und die Struktur des DataNode.
API-Stabilität, Versionierung und Veraltung Wie die RealityConnect API experimentelle Operationen markiert, was als Breaking Change gilt, und die Deprecation-Richtlinie.
Referenz der POI-Symbole (textureId) Alle gültigen textureId-Werte zum Erstellen eines Interessenpunkts (POI) und was jedes Symbol tatsächlich zeigt.
IDs finden: Organisationen, Nodes und Context Finden Sie Ihre Organization-ID, durchsuchen Sie den Node-Baum der RealityConnect API und erfahren Sie, welche ID jede Routenfamilie erwartet.
Referenz: Gemeinsamer Multipart-Upload Das Initiieren-Hochladen-Finalisieren-Muster der RealityConnect-API-Upload-Endpunkte, einschließlich der Regel partNumber vs. startIndex bei der Teilenummerierung.
Typisierte Metadatenwerte und Anhänge Referenz für Metadaten-Eigenschaftswerte der RealityConnect API: die Union aus String/Zahl/Boolean/getaggtem Objekt, die Sentinel-Typen External-Link und Attachment, sowie den Attachment-Upload-, Download- und Löschablauf.
Knoten-Thumbnails Hochladen, Abrufen und Entfernen des Thumbnail-Bilds eines Datenknotens, und wie sich includeThumbnail und thumbnailSignedUrl bei browse und search verhalten.
Netzwerkanforderungen Firewall-, Proxy-, TLS- und Egress-Anforderungen, um die RealityConnect API aus einem Unternehmensnetzwerk zu erreichen, plus eine schrittweise Verbindungsdiagnose.
RealityConnect API FAQ Antworten auf die kommerziellen, architektonischen und 'Kann ich das?'-Fragen zur RealityConnect API, die schon vor der Projektfreigabe aufkommen.