Créer des intégrations multirégionales

La plateforme API de Bluebeam prend en charge les intégrations multirégionales via des URL de base spécifiques à chaque région, permettant aux développeurs et partenaires de concevoir des intégrations pour les clients dans des centaines de pays où Bluebeam est disponible à travers le monde. Les données d’intégration peuvent être stockées dans cinq régions de serveurs : États-Unis, Australie, Allemagne, Royaume-Uni et Suède.

Lors de l’installation d’une intégration, les utilisateurs sélectionnent une région de serveur suivant leurs exigences concernant la résidence des données et la région du serveur Studio. L’intégration peut ensuite être utilisée à l’échelle mondiale, car Bluebeam n’impose pas de géorepérage. En tirant parti de l’URL régionale adéquate ainsi que de vos besoins en matière d’API, vous pouvez offrir une expérience d’intégration cohérente dans différentes zones géographiques tout en respectant les normes locales d’infrastructure et de résidence des données.

Développer des intégrations en dehors des régions prises en charge (États-Unis, Australie, Allemagne, Royaume-Uni et Suède)

Le développement de l’intégration via le Bluebeam Developer Portal est accessible pour les clients actifs, les partenaires de distribution et les partenaires logiciels aux États-Unis, en Australie, en Allemagne, au Royaume-Uni et en Suède. Si votre organisation se trouve en dehors de ces régions, sélectionnez la région prise en charge qui correspond le mieux aux exigences locales de vos clients en matière de résidence des données.

Par exemple, si vous êtes en Inde, vous pouvez créer une intégration qui utilise les points de terminaison de l’API australienne ou ceux de l’API américaine, en fonction des exigences de vos clients en matière de résidence des données locales.

Sélectionner l’URL de base pour la région de votre API Bluebeam

Il existe des URL de base spécifiques à la région qui s'appliquent à tous les points de terminaison :

- États-Unis : https://api.bluebeam.com

- DE : https://api.bluebeamstudio.de

- AU : https://api.bluebeamstudio.com.au

- UK: https://api.bluebeamstudio.co.uk

- SE: https://api.bluebeamstudio.se

Par exemple, https://api.bluebeam.com/publicapi/v1/sessions aux États-Unis serait https://api.bluebeamstudio.com.au/publicapi/v1/sessions en Australie.

Configurer des intégrations multirégionales

1. Accédez au Bluebeam Developer Portal et connectez-vous avec vos identifiants Developer Portal existants.

   Votre compte donne accès à toutes les régions de serveur de l’API Bluebeam, quelle que soit la région de serveur qui vous est initialement associée.

2. Demandez l’accès à l’API Bluebeam par région.

   1. Dans le Developer Portal, accédez à My Apps (Mes applications) et sélectionnez Request Access (Demande d’accès).

   2. Dans le menu déroulant, sélectionnez l’instance régionale de l’API Bluebeam souhaitée.

   3. Complétez tous les champs obligatoires :

      • OAuth 2.0 Grant Type (Type d’accès OAuth 2.0) : sélectionnez uniquement Authorization code (Code d’autorisation) et Refresh token (Jeton d’actualisation).

      • Redirection uri (URL de réponse) : utilisez https://oauth.pstmn.io/v1/callback.

   4. Sélectionnez Request (Demande). L’application que vous avez enregistrée aura accès aux points de terminaison régionaux de l’API Bluebeam.

3. Lors de l’intégration, utilisez l’URL régionale de base pour chaque point de terminaison de l’API Bluebeam.

   Par exemple, l’URL de base aux États-Unis sera https://api.bluebeam.com/publicapi/v1/sessions ; l’URL de base en Australie sera https://api.bluebeamstudio.com.au/publicapi/v1/sessions).

4. Pour créer une URL d’invitation à une session Bluebeam Studio, utilisez l’URL spécifique au serveur Bluebeam Studio :

   • États-Unis : studio.bluebeam.com

   • Allemagne : bluebeamstudio.de

   • Australie : bluebeamstudio.com.au

   • Royaume-Uni : bluebeamstudio.co.uk

   • Suède : bluebeamstudio.se

5. Utilisez votre abonnement Bluebeam existant pour tester les intégrations dans les régions de serveur Studio en dehors de la région du serveur d’origine de votre compte Bluebeam.

   Pour ce faire, créez un Bluebeam ID pour la région du serveur Studio sélectionnée.

6. Sur la page d’inscription de la région du serveur Studio, utilisez votre adresse e-mail existante et créez un nouveau mot de passe propre à cette région de serveur.

   Le système reconnaîtra votre abonnement Bluebeam et accordera l’accès à Bluebeam Studio dans la région de serveur sélectionnée.

7. Connectez-vous à la région du serveur Studio.

   • Sur Revu pour ordinateur, connectez-vous à Revu avec la région de serveur d’origine de votre compte Bluebeam, afin que le système reconnaisse votre abonnement.

     Après vous être connecté(e), sélectionnez la région du serveur Studio de votre choix dans le panneau latéral et connectez-vous séparément.

   • Sur Bluebeam pour Web ou mobile, accédez à app.bluebeam.com et connectez-vous avec le nom d’utilisateur et le mot de passe Bluebeam pour la région spécifique du serveur Studio.

Contacter l’équipe d’assistance au développement

Pour toute question concernant la fonctionnalité des intégrations, les points de terminaison d’API spécifiques et d’autres questions liées à Bluebeam, envoyez-nous un e-mail à integrations@bluebeam.com.

Pour obtenir des informations détaillées sur les points de terminaison des API et les dernières mises à jour de la plateforme d’intégrations, consultez la section API Docs du Developer Portal.

Ressources

Revu 21

Intégrations Bluebeam

Intégrations Bluebeam