Bluebeam Integrationszentrum

Willkommen beim Bluebeam Integrationszentrum. In diesen Ressourcen erfahren Sie mehr über Bluebeam-Integrationen, den Zugriff darauf und die Entwicklung privater oder öffentlicher Integrationen zwischen Bluebeam und Software von Drittanbietern.

FAQ zu den Integrationen von Bluebeam

Lesen Sie Antworten auf häufig gestellte Fragen von Bluebeam-Anwendern und Partnerentwicklern zum Zugriff auf und zum Erstellen von Integrationen. Unabhängig davon, ob Sie bestehende Integrationen aktivieren oder neue entwickeln, führen diese Fragen Sie durch wichtige Themen wie Kontoeinrichtung, Authentifizierung, API-Nutzung und Verwaltung Ihrer Integrationen im Developer Portal.

Integrationsbenutzer

Da die Drittanbieterintegrationen von Partnern oder Entwicklern entwickelt werden, können für einige von ihnen besondere Anforderungen gelten, wie z. B. kompatible Anwendungsversionen oder zusätzliche Kosten. Wenn Sie Fragen zur Installation oder zum Upgrade auf die neueste Version einer Integration haben, wenden Sie sich bitte direkt an den Integrationspartner oder Entwickler.

Bluebeam-Kunden, die Integrationen nutzen, sollten sich direkt an den Integrationspartner wenden, um bei Bedarf die neueste Version zu installieren oder ein Upgrade darauf auszuführen. Für die Nutzung der Integrationen müssen Sie innerhalb von Bluebeam keine Aktualisierungen vornehmen, sie brauchen lediglich ein aktives Bluebeam Abo.

Wir stellen im Bluebeam Integrationsverzeichnis Links zu den Websites unserer Integrationspartner bereit.

Ja! Ein wichtiger Aspekt der Umstellung auf die neue Plattform besteht darin, unseren Kunden die Nutzung von SSO/SCIM bei der Verwendung von Integrationen zu ermöglichen. Dies wird einigen Benutzern beim Übergang zu einem Bluebeam-Abo helfen.

Drittanbieterintegrationen können auch ohne Abo für Org Admin Pro genutzt werden.

Um Studio-Sitzungen und -Projekte über eine Integration zu erstellen, benötigen Sie ein Bluebeam Core-, Complete- oder Max-Abo.

Um über eine Integration an Studio-Sitzungen und -Projekten teilnehmen und daran mitarbeiten zu können, benötigen Sie mindestens ein Bluebeam Basics-Abo.

Wenn Sie bereits Revu 20 haben, können Sie über eine Integration an Studio-Sitzungen und Studio-Projekten teilnehmen und daran mitarbeiten. Sie können diese nicht über die Bluebeam Studio-API erstellen.

Um Studio-Sitzungen und Studio-Projekte über eine Integration zu erstellen, müssen Sie ein Upgrade auf ein Bluebeam Core, Complete oder Max Abo durchführen.

 

Integrationsentwickler

Das Bluebeam Developer Portal für die Integrationsentwicklung steht nur aktiven Kunden, Vertriebspartnern und Softwarepartnern in den Regionen US, AU, DE, UK und SE zur Verfügung. Wenn Sie außerhalb dieser Regionen ansässig sind, wählen Sie bitte je Ihren lokalen Anforderungen an die Datenresidenz und mögliche Überlegungen zur Datenlatenz eine der oben genannten Regionen aus.

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.

Ein 404-Bad-Request-Fehler kann durch ein Token-Problem verursacht werden. Dies kann passieren, wenn auf dem Anmeldebildschirm automatisch ein anderes Benutzerkonto ohne Zugriff auf das Developer Portal ausgewählt wurde. Mit dem falschen Token können Sie sich dann nicht erfolgreich anmelden. Um das Problem zu beheben, müssen Sie sich mit dem richtigen Konto anmelden, das Zugriff auf das Developer Portal hat.

Wir empfehlen außerdem, die folgenden Schritte zur Fehlerbehebung von Fehlermeldung „404 Bad Request“ auszuprobieren:

- Versuchen Sie, über ein Inkognito-Fenster oder in einen anderen Browser auf das Developer Portal zuzugreifen, um sich mit den Anmeldeinformationen für das Developer Portal anzumelden.

- Löschen Sie den Cache Ihres Browsers und versuchen Sie, sich mit den Anmeldeinformationen für das Developer Portal anzumelden.

Wenn das Problem durch die oben genannten Schritte nicht behoben werden kann, hängt das Problem möglicherweise mit der SSO-Authentifizierung (Single Sign-On) zusammen. Wenn Ihre Domain SSO mit einem Authentifikator wie Okta Workforce verwendet, kann dies zu einem Konfigurationskonflikt führen, der zu einem 404-Fehler „Bad Request“ führt. Um dieses Problem zu beheben, stellen Sie sicher, dass Sie das Developer Portal zu Ihrer Lizenzierungsgruppe hinzufügen. Dadurch wird das Problem behoben und Sie haben ordnungsgemäßen Zugriff.

1. Sie müssen auch offline_access als Berechtigung aktivieren, wenn Sie Ihren Zugriffstoken generieren.

2. Für die Anfragen zum Aktualisierungstoken benötigen Sie nur die Felder „refresh_token“ und „grant_type“ im Textkörper. Sie dürfen darüber hinaus keine weiteren Angaben hinzufügen.

3. Formatieren Sie den Autorisierungs-Header wie folgt:
Authorization Basic {base64 encoded string of client_id:client_secret}

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

Versionshinweise zu Bluebeam Integrations

 

Wichtige Änderungen am Bluebeam Developer Portal

  • Das Bluebeam Developer Portal wurde neu aufgebaut, um Entwicklern eine schnellere, klarere und stärker auf Selbstbedienung basierende Erfahrung zu bieten.

  • Die Nutzeroberfläche zur Anzeige der API-Dokumentation wurde verbessert, einschließlich einer neuen Suche zum Finden von Stichwortübereinstimmungen.

  • Eine brandneue Funktion „Testanfrage“ wurde eingeführt, die es Entwicklern ermöglicht, Endpunkte im Browser in verschiedenen Programmiersprachen zu testen.

  • Vereinfachte Optionen beim Erstellen einer neuen Anwendung

  • Weitere Anwendungsdetails und Update-Optionen zur Tabelle „Meine Apps“ hinzugefügt

  • Der Onboarding-Prozess wurde für Nutzer mit einer aktiven BBID und einem Core-, Complete- oder Max -Abo optimiert.

  • Neue Arbeitsabläufe wurden eingeführt zum Erstellen von Anwendungen in der Sandbox-Umgebung und zum Einreichen bei unserem Team zur Veröffentlichung in der Produktion.

  • Markierungen-Endpunkte sind nicht mehr in der Beta-Phase und für alle Entwickler-Nutzer verfügbar.

Wichtige Änderungen an der Ratenbegrenzung für Bluebeam-Integrationen

Als Teil unseres Engagements für den Aufbau einer zuverlässigen Integrationsplattform führen wir ab dem 1. Juli 2026 Integrationsratelimits ein. Diese Ratelimits tragen dazu bei, dass jeder Partner eine konsistente, zuverlässige API-Leistung erhält, während unser Ökosystem wächst.

Was bedeutet das für Sie?

Nach dem 1. Juli 2026 erhalten Nutzeranfragen, die das Limit überschreiten, einen "Too Many Requests" HTTP 429-Fehler und werden nicht verarbeitet.

Was ändert sich?

Sitzungsendpunkte

  • GET /publicapi/v1/sessions/*
    - 150 Anfragen/Minute über alle Sitzungs-GET-Endpunkte hinweg

  • POST/PUT/DELETE /publicapi/v1/sessions/*
    - 50 requests/minute über alle anderen Sitzung-Endpunkte

Projekt-Endpunkte

  • GET /publicapi/v1/projects/*
    - 150 Anfragen/Minute

  • POST/PUT/DELETE /publicapi/v1/projects/*
    - 50 Anfragen/Minute

Auftragsendpunkte

  • GET & PUT /publicapi/v1/jobs/*
    - 100 requests/minute

Was können Sie tun?

  • Messen Sie Ihre Ratenbegrenzungen mithilfe der Ratenbegrenzungs-Header und passen Sie die Integrationen entsprechend an.

  • Ersetzen Sie Abrufmuster durch Webhooks, wo immer möglich, um das Anforderungsvolumen zu reduzieren.

Haben Sie Fragen? Kontaktieren Sie uns.

Update für das Bluebeam Studio-Projekte RevisionsID-Baustelle

Am 2. März 2026 aktualisieren wir die Baustelle RevisionID in den API-Antworten von Studio-Projekten. Diese Änderung ist wichtig für den Support der Gesamtleistung und des langfristigen Wachstums von Bluebeam Studio.

Die Bluebeam Studio API ändert den zugrunde liegenden Wert der Baustelle RevisionID in eine andere interne Kennung für die folgenden Endpunkte:

Methode

Endpunkt

ABRUFEN

/v1/projects/{projectId}/files

ABRUFEN

/v1/projects/{projectId}/files/by-path?path={path}

ABRUFEN

/v1/projects/{projectId}/files/{fileId}

ABRUFEN

/v1/projects/{projectId}/folders/{id}/Objekte

ABRUFEN

/v1/projects/{projectId}/files/{fileId}/revisions

ABRUFEN

/v1/projects/{projectId}/files/{fileId}/Revisionen/{id}

Beiträge veröffentlichen

/v1/projects/{projectId}/files/{fileId}/revisions/{id}/restore

Wenn Sie RevisionID intern speichern oder zwischenspeichern:

  • Sie sollten alle zwischengespeicherten Revisionsdaten nach dem 2. März 2026 aktualisieren, indem Sie den neuen Endpunkt der Revisionsliste aufrufen, um aktuelle Werte abzurufen.

  • Wenn Sie die zwischengespeicherten Revisionen nicht aktualisieren, kann Ihre Integration nach dem 2. März 2026 Fehler verursachen.

GET /v1/projects/{projectId}/files

Vorher

Nachher

[{
"$id": "12",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Berechtigungen": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": Ja,
"InSession": Nein,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 705422365
}..]

[{
"$id": "12",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Permission": "Berechtigung",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": Ja,
"InSession": Nein,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1", "RevisionID": 2
}..]

 

GET /v1/projects/{projectId}/files/by-path?path={path}

Vorher

Nachher

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/ac5....0d7d5?AWSAccessKeyId=AIA3E5....
WX&Expires=1770257465&x-amz-security-token=xxxx",
"Id": 380657794,
"Name": "grid.pdf",
"Path": "/level1/grid.pdf",
"ParentFolderId": 380657776,
"Created": "2025-12-16T23:42:11.39976",
"Berechtigungen": "ReadWriteDelete",
"CRC": "90B707AA",
"Size": 3256,
"IsLocked": Ja,
"InSession": Nein,
"LockOwnerEmail": "DocusignIntegration@bluebeam.com",
"LockOwnerName": "DocusignIntegration",
"RevisionID": 872381127
}

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/ac5....0d7d5?AWSAccessKeyId=AIA3E5....
WX&Expires=1770257465&x-amz-security-token=xxxx",
"Id": 380657794,
"Name": "grid.pdf",
"Path": "/level1/grid.pdf",
"ParentFolderId": 380657776,
"Created": "2025-12-16T23:42:11.39976",
"Berechtigungen": "ReadWriteDelete",
"CRC": "90B707AA",
"Size": 3256,
"IsLocked": Ja,
"InSession": Nein,
"LockOwnerEmail": "DocusignIntegration@bluebeam.com",
"LockOwnerName": "DocusignIntegration",
"RevisionID": 2
}

 

GET /v1/projects/{projectId}/files/{fileId}

Vorher

Nachher

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/269c72afe30547b9a3c0b81141ef2e87/7d1619
57d3314c67ae93bc9e1c283b8b?AWSAccessKeyId=xxxx",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Berechtigungen": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": Ja,
"InSession": Nein,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 705422365
}

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/269c72afe30547b9a3c0b81141ef2e87/7d1619
57d3314c67ae93bc9e1c283b8b?AWSAccessKeyId=xxxx",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Berechtigungen": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": Ja,
"InSession": Nein,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 2
}

 

GET /v1/projects/{projectId}/folders/{id}/Objekte

Vorher

Nachher

{
"$id": "1",
"ProjectFiles": [
{
"$id": "2",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Berechtigungen": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": Ja,
"InSession": Nein,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 705422365
}
],
"ProjectFolders": [],
"TotalCount": 1
}

{
"$id": "1",
"ProjectFiles": [
{
"$id": "2",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Berechtigungen": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": Ja,
"InSession": Nein,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 2
}
],
"ProjectFolders": [],
"TotalCount": 1
}

 

GET /v1/projects/{projectId}/files/{fileId}/revisions

Vorher

Nachher

{
"$id": "1",
"ProjectFileRevisions": [
{
"$id": "2",
"Id": 705422176,
"Kommentar": "",
"CRC": "799548DA",
"OperationType": "Add",
"RevisionNumber": 872381127,
"RevisionRestorable": Ja,
"Size": 78207,
"Timestamp": "2025-04-23T23:57:22.23021",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
},
{
"$id": "3",
"Id": 705422365,
"Kommentar": "Signiert von DocuSign",
"CRC": "00000000",
"OperationType": "CheckIn",
"RevisionNumber": 705422365,
"RevisionRestorable": Nein,
"Size": 0,
"Timestamp": "2025-04-23T23:59:29.535663",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
}
]
}

{
"$id": "1",
"ProjectFileRevisions": [
{
"$id": "2",
"Id": 1,
"Kommentar": "",
"CRC": "799548DA",
"OperationType": "Add",
"RevisionNumber": 1,
"RevisionRestorable": Ja,
"Size": 78207,
"Timestamp": "2025-04-23T23:57:22.23021",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"Nutzername": "BBIntegrations Demo1"
},
{
"$id": "3",
"Id": 2,
"Kommentar": "Signed from DocuSign",
"CRC": "00000000",
"OperationType": "CheckIn",
"RevisionNumber": 2,
"RevisionRestorable": Nein,
"Size": 0,
"Timestamp": "2025-04-23T23:59:29.535663",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"Nutzername": "BBIntegrations Demo1"
}
]
}

 

GET v1/projects/{projectId}/files/{fileId}/Revisionen/{id}

Vorher

Nachher

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/269c72afe30547b9a3c0b81141ef2e87/7d1619
57d3314c67ae93bc9e1c283b8b?versionId=AU37klPj9j
ikuGgh3CzsQdXw7lt2pSDQ&AWSAccessKeyId=ASI
A3E5OIX5P4BM7EBVL&Expires=1770253559&x-
amz-security-token=IQoJb3JpZ2luXxxx",
"Id": 705422176,
"Kommentar": "",
"CRC": "799548DA",
"OperationType": "Add",
"Revisionsnummer": 705422365,
"RevisionRestorable": Ja,
"Size": 78207,
"Timestamp": "2025-04-23T23:57:22.23021",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
}

{
"$id": "1",
"DownloadUrl":
"https://s3.amazonaws.com/bluebeam.studio.documents
/projects/269c72afe30547b9a3c0b81141ef2e87/7d1619
57d3314c67ae93bc9e1c283b8b?versionId=AU37klPj9j
ikuGgh3CzsQdXw7lt2pSDQ&AWSAccessKeyId=ASI
A3E5OIX5P4BM7EBVL&Expires=1770253559&x-
amz-security-token=IQoJb3JpZ2luXxxx",
"Id": 2,
"Kommentar": "",
"CRC": "799548DA",
"OperationType": "Add",
"RevisionNumber": 1,
"RevisionRestorable": Ja,
"Size": 78207,
"Timestamp": "2025-04-23T23:57:22.23021",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
}

Endpunkte, die RevisionID als Eingabe akzeptieren:

Methode

Endpunkt

Beschreibung

ABRUFEN

/v1/projects/{projectId}/files/{fileId}/Revisionen/{id}

Revisionsmetadaten abrufen

Beiträge veröffentlichen

/v1/projects/{projectId}/files/{fileId}/revisions/{id}/restore

Datei auf Revision wiederherstellen

Updates zum Bluebeam API Lizenzzugang

Führen Sie ein Upgrade auf Bluebeam Core oder Complete durch, um die Erstellen-Funktion über eine Integration aufrechtzuerhalten.

Als Teil unseres Engagements, die bestmöglichste Erfahrung über die Bluebeam Studio API zu liefern, haben wir die Berechtigungen für Lizenzintegrationsfunktionen am 20. Februar 2026 eingestellt.

Was dies bedeutet:

  • Integration-Nutzer auf Revu 20 können über eine Integration an Studio-Sitzungen und Projekten teilnehmen und daran mitarbeiten, sind aber nach dem 20. Februar 2026 nicht mehr in der Lage, diese über eine Integration zu erstellen.

  • Um Studio-Sitzungen und -Projekte über eine Integration weiterhin zu erstellen, müssen Nutzer bis zum 20. Februar 2026 ein Upgrade auf ein Bluebeam Core- oder Complete-Abo durchführen.

Hier erfahren Sie mehr über die Bluebeam Abo-Pläne: Abo-Funktionen.

Markierungen-API – Verbesserungen

Release-Zugang: Beta

  • Erweitert die im Jahr 2025 veröffentlichte Markierungen-API V1 um neue, unten aufgeführte Funktionen.

  • Fügt Lesezugriff auf zusätzliche Baustellen der Markierungsliste für einen umfangreicheren Markierungskontext hinzu.

  • Einführung des Zugriffs auf den Änderungsverlauf von Markierungen

  • Als Beta-Version veröffentlicht; Funktionalität und Umfang können sich entwickeln.

  • Aktualisierte Developer Portal-Dokumentation ist jetzt verfügbar.

Markierungsdaten

Markierungen API v1

Markierungen API v2

Markierungen-Identifikatoren:
markupID | documentId

- sessionId

SCHREIBGESCHÜTZT

SCHREIBGESCHÜTZT

E-Mail
z. B., example@gmail.com

SCHREIBGESCHÜTZT

SCHREIBGESCHÜTZT

Anzeigename
z. B. Test

SCHREIBGESCHÜTZT

SCHREIBGESCHÜTZT

Typ
(z. B. Linie)

SCHREIBGESCHÜTZT

SCHREIBGESCHÜTZT

Betreff
(z. B. Pfeil)

SCHREIBGESCHÜTZT

SCHREIBGESCHÜTZT

Betreff

SCHREIBGESCHÜTZT

SCHREIBGESCHÜTZT

Erzeugt

SCHREIBGESCHÜTZT

SCHREIBGESCHÜTZT

Geändert

SCHREIBGESCHÜTZT

SCHREIBGESCHÜTZT

Status

SCHREIBGESCHÜTZT

SCHREIBGESCHÜTZT

Sperren

X

SCHREIBGESCHÜTZT

Seitennummer

X

SCHREIBGESCHÜTZT

Comments

X

SCHREIBGESCHÜTZT

Ebene

X

SCHREIBGESCHÜTZT

Etikett

X

SCHREIBGESCHÜTZT

Abmessungsdaten

X

SCHREIBGESCHÜTZT

Benutzerdefinierte Spalte(n)

X

SCHREIBGESCHÜTZT

Geometrie

X

SCHREIBGESCHÜTZT

Benutzerdefinierte Status

X

SCHREIBGESCHÜTZT

Statusautor

X

X

Status aktualisiert

X

X

Verfasser*

X

SCHREIBGESCHÜTZT

Stempel

SCHREIBGESCHÜTZT

SCHREIBGESCHÜTZT

Ressourcen

Revu 21

Bluebeam Integrationen

Bluebeam Integrationen

In diesen Ressourcen erfahren Sie mehr über Bluebeam-Integrationen, den Zugriff darauf und die Entwicklung privater oder öffentlicher Integrationen zwischen Bluebeam und Software von Drittanbietern.