RealityConnect API FAQ
Certaines questions n’appartiennent à aucune page de référence en particulier. Elles sont commerciales, architecturales, ou portent sur ce que l’API ne fait pas. Cette page rassemble celles qui reviennent le plus souvent en support, en solutions engineering et lors des appels commerciaux, avant même qu’une seule ligne de code soit écrite.
Puis-je accéder à plusieurs organisations avec un seul jeu d’identifiants ?
Section intitulée « Puis-je accéder à plusieurs organisations avec un seul jeu d’identifiants ? »Non, par conception. Chaque jeton OAuth est limité en permanence à l’organisation pour laquelle il a été émis, et il n’existe aucun moyen de changer d’organisation ou de lire plusieurs organisations avec un seul jeu d’identifiants. Voir l’Introduction et l’Aperçu des capacités pour la vue d’ensemble de ce que l’API peut et ne peut pas faire.
Pourquoi ma liste est-elle vide alors que mon jeton a tous les scopes ?
Section intitulée « Pourquoi ma liste est-elle vide alors que mon jeton a tous les scopes ? »Vérifiez l’accès au contenu et le rôle, pas les scopes. Les scopes OAuth ne sont que la couche 1 du modèle de sécurité, si bien qu’un jeton disposant de tous les scopes ne voit toujours que les nœuds pour lesquels le compte appelant a un accès au contenu, et ne peut agir que dans les limites du rôle qui lui est assigné sur ce nœud. Un résultat vide signifie presque toujours un problème de couche 2 ou 3, pas un scope manquant. Scopes OAuth par tâche permet de confirmer que vous avez au moins les bons scopes ; vérifiez ensuite l’accès au contenu et le rôle du compte appelant sur ce nœud.
Comment trouver la région de mon organisation ?
Section intitulée « Comment trouver la région de mon organisation ? »Appelez GET /oauth/api-info avec votre jeton d’accès. La réponse contient votre apiUrl régionale et votre organization.id. Ne codez jamais en dur une URL régionale. Voir Premiers pas et le Flux Client Credentials pour un exemple complet.
Puis-je utiliser l’API sans licence RealityTwin ni siège RealityPlan ?
Section intitulée « Puis-je utiliser l’API sans licence RealityTwin ni siège RealityPlan ? »Pour l’essentiel, oui. Une licence RealityTwin Data Manager n’est consommée que par les appels touchant au contenu d’un twin (actifs, POI, zones, brouillons, recherche, métadonnées d’objets, sessions d’embed et bibliothèque d’actifs). La gestion des utilisateurs et des invitations, les rôles, et l’appel de découverte /oauth/api-info ne touchent aucun twin et ne consomment pas de licence. Certains points de terminaison liés à RealityPlan consomment également un siège RealityPlan. Voir Licences.
Existe-t-il un environnement de test ou sandbox ?
Section intitulée « Existe-t-il un environnement de test ou sandbox ? »Aucun environnement de sandbox ou d’essai dédié n’existe aujourd’hui. Le moyen le plus simple d’essayer l’API est de créer une application Client Credentials dans votre propre organisation. Voir Choisir un flux OAuth.
Comment conserver les identifiants de mon système sur les objets Prevu3D ?
Section intitulée « Comment conserver les identifiants de mon système sur les objets Prevu3D ? »Il n’existe aucun champ réservé à cet usage. Utilisez une propriété simple de type chaîne ou nombre dans les métadonnées de l’objet, par exemple une section nommée « External IDs » contenant l’identifiant de votre système. Les métadonnées sont des données clé/valeur libres, pas un schéma figé, donc n’importe quel nom de propriété fonctionne sans rien provisionner au préalable. Voir Valeurs de métadonnées typées et pièces jointes.
Et ensuite ?
Section intitulée « Et ensuite ? »- Aperçu des capacités pour ce que l’API peut lire, écrire, et ne fait pas du tout.
- Premiers pas pour le modèle de sécurité, les licences et le choix d’un flux OAuth.
- Explorez la référence API pour le catalogue complet des endpoints.