Salta ai contenuti
Prevu3D

RealityConnect API FAQ

Alcune domande non appartengono a nessuna pagina di riferimento in particolare: sono commerciali, architetturali, oppure riguardano ciò che l’API non fa. Questa pagina raccoglie quelle che emergono più spesso nelle conversazioni di supporto, solutions engineering e vendita, ancora prima che venga scritta una sola riga di codice.

Posso accedere a più di un’organizzazione con un unico set di credenziali?

Sezione intitolata “Posso accedere a più di un’organizzazione con un unico set di credenziali?”

No, per progettazione. Ogni token OAuth è vincolato in modo permanente all’organizzazione per cui è stato emesso: non esiste un modo per passare da un’organizzazione all’altra o leggere tra organizzazioni con un unico set di credenziali. Consulta l’Introduzione e la Panoramica delle funzionalità per il quadro completo di ciò che l’API può e non può fare.

Perché il mio elenco risulta vuoto anche se il mio token ha tutti gli scope?

Sezione intitolata “Perché il mio elenco risulta vuoto anche se il mio token ha tutti gli scope?”

Controlla l’accesso ai contenuti e il ruolo, non gli scope. Gli scope OAuth sono solo il livello 1 del modello di sicurezza: un token con tutti gli scope vede comunque solo i nodi a cui l’account chiamante ha accesso ai contenuti, e può agire solo entro il ruolo assegnato su quel nodo. Un risultato vuoto indica quasi sempre un problema di livello 2 o 3, non uno scope mancante. Scope OAuth per attività conferma se hai almeno gli scope corretti; da lì, verifica l’accesso ai contenuti e il ruolo dell’account chiamante su quel nodo.

Come trovo la regione della mia organizzazione?

Sezione intitolata “Come trovo la regione della mia organizzazione?”

Chiama GET /oauth/api-info con il tuo access token: la risposta include la tua apiUrl regionale e il tuo organization.id. Non codificare mai staticamente un URL regionale. Consulta Per iniziare e il Flusso Client Credentials per un esempio completo.

Posso usare l’API senza una licenza RealityTwin o un posto RealityPlan?

Sezione intitolata “Posso usare l’API senza una licenza RealityTwin o un posto RealityPlan?”

Per la maggior parte, sì. Una licenza RealityTwin Data Manager viene consumata solo dalle chiamate che riguardano contenuti di un twin: asset, POI, zone, bozze, ricerca, metadati degli oggetti, sessioni di embed e libreria degli asset. La gestione di utenti e inviti, i ruoli e la chiamata di discovery /oauth/api-info non riguardano alcun twin e non consumano una licenza. Alcuni endpoint relativi a RealityPlan consumano anche un posto RealityPlan. Consulta Licenze.

Esiste un ambiente di test o sandbox?

Sezione intitolata “Esiste un ambiente di test o sandbox?”

Oggi non esiste un ambiente sandbox o di prova dedicato. Il modo più semplice per provare l’API è creare un’applicazione Client Credentials nella tua organizzazione. Consulta Scegli un flusso OAuth.

Come posso conservare gli identificatori del mio sistema sugli oggetti Prevu3D?

Sezione intitolata “Come posso conservare gli identificatori del mio sistema sugli oggetti Prevu3D?”

Non esiste un campo riservato a questo scopo: usa una proprietà semplice di tipo stringa o numero nei metadati dell’oggetto, ad esempio una sezione chiamata “External IDs” contenente l’identificatore del tuo sistema. I metadati sono dati chiave/valore a forma libera, non uno schema fisso, quindi qualsiasi nome di proprietà funziona senza dover provisionare nulla in anticipo. Consulta Valori di metadati tipizzati e allegati.

Cosa c’è dopo?

Sezione intitolata “Cosa c’è dopo?”