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. Studio-Daten können über eine Integration 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 Region Ihres Bluebeam Abos bestimmt, welche API-Serverregion Sie verwenden können. Da Studio-Sitzungen und -Projekte ein an diese Region gebundenes Core-, Complete- oder Max-Abo erfordern, schlagen API-Aufrufe außerhalb der Region Ihres Abos fehl.

Um Integrationen in zwei oder mehr Serverregionen zu erstellen, benötigen Sie zwei oder mehr BBIDs: eine pro Region, jeweils eingerichtet mit einer eindeutigen E-Mail-Adresse und einem dieser Region zugewiesenen Core-, Complete- oder Max-Abo.

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:

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.
Ihre Bluebeam-Abo-Region, die Studio-Serverregion und die API-Integrationsregion müssen übereinstimmen. Andernfalls erhalten Sie beim Versuch, eine Anwendung in einer Region zu Erstellen, die nicht mit Ihrer Bluebeam-Abo-Region übereinstimmt, die folgende Fehlermeldung: „No Okta Nutzer found.”
Ü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 nutzen Sie Anmelden mit Ihren BBID-Anmeldedaten über Okta.

    Ihr Bluebeam-Abo gewährt Ihnen Zugriff auf die API-Serverregion, die der Region Ihres Abos entspricht. Wenn die Region Ihres Bluebeam-Abos beispielsweise US ist, können Sie nur in der US-API-Region erstellen und Aufrufe tätigen.

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

    1. Wechseln Sie im Developer Portal zu My Apps und Anwendung Erstellen auswählen.

    2. Verwenden Sie das Drop-down-Menü, um die Ihrer Region entsprechende API-Instanz bei der Registrierung auszuwählen.

    3. Füllen Sie alle Pflichtfelder aus:

      • Anwendungsname

      • Beschreibung

      • Region

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

    4. Anwendung erstellen auswählen. Ihre registrierte App erhält Zugriff auf die regionsspezifischen Bluebeam API-Endpunkte.

  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. Um Integrationen in zwei oder mehr Serverregionen zu erstellen, benötigen Sie zwei oder mehr BBIDs: eine pro Region, die jeweils mit einer eindeutigen E-Mail-Adresse und einem der jeweiligen Region zugewiesenen Core-, Complete- oder Max -Abo eingerichtet ist.

    Um beispielsweise eine Integration in der australischen API-Region zu erstellen und zu testen, müssen Ihr Bluebeam-Abo und Ihre E-Mail-Adresse der australischen Region zugewiesen sein.

  6. Nachdem Sie mit einem Core-, Complete- oder Max-Abo, das der API-Serverregion entspricht, eine Bluebeam ID erstellt haben, können Sie mit diesen Zugangsdaten auf das Developer Portal zugreifen und eine Integration in der entsprechenden API-Region erstellen.

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.