Erstellen von Integrationen für mehrere Regionen

Die API-Plattform von Bluebeam unterstützt Integrationen in mehreren Regionen über regionsspezifische Basis-URLs und ermöglicht es Entwicklern und Partnern, Integrationen für Kunden in Hunderten von Ländern weltweit aufzubauen. Integrationsdaten können in fünf Serverregionen gespeichert werden: USA, Australien, Deutschland, Großbritannien und Schweden.

Bei der Installation einer Integration wählen Benutzer eine Serverregion entsprechend ihren Bedürfnissen hinsichtlich der Datenablage und der Studio-Serverregion aus. Die Integration kann dann global verwendet werden, da Bluebeam ohne Geofencing funktioniert. Indem Sie neben Ihren API-Anforderungen auch die entsprechende regionsspezifische URL verwenden, können Sie eine einheitliche Integrationserfahrung ohne Abhängigkeit von Regionen bieten und gleichzeitig die lokalen Infrastruktur- und Datenhaltungsstandards einhalten.

Entwicklung von Integrationen außerhalb der unterstützten Regionen (USA, AU, DE, GB und SE)

Die Integrationsentwicklung über das Bluebeam Developer Portal steht aktiven Kunden, Vertriebspartnern und Softwarepartnern in den Regionen USA, AU, DE, UK und SE zur Verfügung. Wenn sich Ihre Organisation außerhalb dieser Regionen befindet, wählen Sie eine unterstützte Region aus, die den lokalen Anforderungen Ihrer Kunden an die Datenablage am besten entspricht.

Wenn Sie sich beispielsweise in Indien befinden, können Sie eine Integration erstellen, die je nach den lokalen Datenaufbewahrungsanforderungen Ihrer Kunden die API-Endpunkte für Australien oder die API-Endpunkte für die USA verwendet.

Kunden können die Serverregion auf der Grundlage ihrer eigenen Projekt- und Datenresidenzanforderungen auswählen.
Die Studio-Serverregion muss mit der Integrationsserverregion übereinstimmen.

Wählen Sie die Basis-URL für Ihre Bluebeam-API-Region aus.

Die Bluebeam-API-Endpunkte bleiben in allen Regionen gleich; nur die Basis-URLs unterscheiden sich je nach ausgewählter Region.

Es gibt regionsspezifische Basis-URLs, die für alle Endpunkte gelten:

- US: 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

https://api.bluebeam.com/publicapi/v1/sessions in den USA wäre also https://api.bluebeamstudio.com.au/publicapi/v1/sessions in AU.

Integrationen für mehrere Regionen einrichten

Jede Studio-Serverregion arbeitet unabhängig; Sitzungen und Projekte werden nicht zwischen Serverregionen übertragen.
Die Studio-Serverregion muss mit der Integrationsserverregion übereinstimmen.
Überprüfen Sie bei der Auswahl der Serverregionen immer die regionalen Anforderungen an Datenaufbewahrung und Latenzzeiten für Ihre Kunden.

  1. Navigieren Sie zum Bluebeam Developer Portal und melden Sie sich mit Ihren bestehenden Anmeldedaten für das Developer Portal an.

    Ihr Konto bietet Zugriff auf alle Serverregionen der Bluebeam API, unabhängig von Ihrer ursprünglichen Serverregionszuordnung.

  2. Beantragen Sie den Bluebeam API-Zugang nach Region.

    1. Wechseln Sie im Developer Portal zu My Apps und wählen Sie Request Access aus.

    2. Nutzen Sie das Dropdown-Menü, um Ihre gewünschte Instanz der Bluebeam-API-Region auszuwählen.

    3. Füllen Sie alle Pflichtfelder aus:

      • OAuth 2.0-Grant-Typ: Wählen Sie nur Authorization code und Refresh token aus.

      • Umleitungs-URI: Verwenden Sie https://oauth.pstmn.io/v1/callback.

    4. Wählen Sie Anfragre aus. Ihre registrierte App erhält Zugriff auf die regionsspezifischen Endpunkte der Bluebeam API.

  3. Verwenden Sie bei der Integration die passende regionsspezifische Basis-URL für jeden Bluebeam-API-Endpunkt.

    Beispielsweise lautet die Basis-URL in den USA https://api.bluebeam.com/publicapi/v1/sessions; die Basis-URL in AU wird https://api.bluebeamstudio.com.au/publicapi/v1/sessions sein).

  4. Verwenden Sie die für den Bluebeam Studio-Server spezifische URL, um eine Einladungs-URL zu Bluebeam Studio-Sitzungen zu erstellen:

  5. Verwenden Sie Ihr vorhandenes Bluebeam-Abo, um Integrationen in Studio-Serverregionen außerhalb der ursprünglichen Serverregion Ihres Bluebeam-Kontos zu testen.

    Erstellen Sie dazu eine Bluebeam-ID für die ausgewählte Studio-Serverregion.

  6. Verwenden Sie auf der Anmelde-Seite für die Studio-Serverregion Ihre bestehende E-Mail-Adresse und erstellen Sie ein neues Passwort, das nur für diese Serverregion gilt.

    Das System erkennt Ihr Bluebeam-Abo und gewährt Zugriff auf Bluebeam Studio in der ausgewählten Serverregion.

  7. Melden Sie sich bei der Studio-Serverregion an.

    • Melden Sie sich auf dem Revu-Desktop mit der ursprünglichen Serverregion Ihres Bluebeam-Kontos bei Revu an. Dadurch wird sichergestellt, dass das System Ihr gültiges Abo erkennt.

      Wählen Sie nach der Anmeldung in der Seitenleiste die gewünschte Studio-Serverregion aus und melden Sie sich separat an.

    • Rufen Sie auf Bluebeam für das Web oder Mobilgerät die app.bluebeam.com auf und melden Sie sich mit dem Bluebeam-Benutzernamen und dem Passwort für die gewünschte Studio-Serverregion an.

Entwickler-Support kontaktieren

Wenn Sie Fragen zur Integrationsfunktionalität, zu bestimmten API-Endpunkten oder zu anderen Bluebeamthemen haben, senden Sie uns eine E-Mail an integrations@bluebeam.com.

Für detaillierte Informationen zu API-Endpunkten und den neuesten Aktualisierungen der Integrationsplattform besuchen Sie den API Docs-Abschnitt im Developer Portal.

Ressourcen

Revu 21

Bluebeam Integrationen

Bluebeam Integrationen

Die API-Plattform von Bluebeam unterstützt Integrationen in mehreren Regionen über regionsspezifische Basis-URLs und ermöglicht es Entwicklern und Partnern, Integrationen für Kunden in Hunderten von Ländern weltweit aufzubauen.