Bluebeam Integrations Hub

Välkommen till Bluebeams integrationshubb. Använd dessa resurser för att lära dig mer om vad Bluebeam-integrationer är, hur du får tillgång till integrationerna och hur du utvecklar privata eller offentliga integrationer mellan Bluebeam och programvara från tredje part.

Vanliga frågor om Bluebeam-integrationer

Läs svar på vanliga frågor från Bluebeam-användare och partnerutvecklare om att komma åt och bygga integrationer. Oavsett om du aktiverar befintliga integrationer eller utvecklar nya, vägleder dessa frågor dig genom viktiga ämnen som kontoinställning, autentisering, API-användning och hantering av dina integrationer i Developer Portal.

Integrationsanvändare

Eftersom integrationer från tredje part utvecklas av integrationspartners eller utvecklare kan vissa av dem ha specifika krav, till exempel kompatibla programvaruversioner eller ytterligare kostnader. Om du har frågor om installation eller uppgradering till den senaste versionen av en integration kan du kontakta den aktuella integrationspartnern eller utvecklaren för hjälp.

Bluebeam-kunder som använder integrationer bör samarbeta direkt med integrationspartnerna för att installera eller uppgradera till den senaste versionen av en integration vid behov. Du behöver inte uppdatera något i Bluebeam för att använda integrationerna, förutom att du behöver ha en aktiv Bluebeam-prenumerationsplan.

Vi tillhandahåller länkar till våra integrationspartners webbplatser i Bluebeam Integrations Directory.

Ja! En stor del av övergången till den nya plattformen är att våra kunder ska kunna använda SSO/SCIM för integrationer. Det kommer att hjälpa vissa användare att fullborda sin övergång till en Bluebeam-prenumerationsplan.

Integrationer från tredje part kan användas utan en prenumeration på Org Admin Pro.

För att skapa Studio-sessioner och Studio-projekt genom en integration måste du ha en Bluebeam-prenumerationsplan av typen Core, Complete eller Max.

För att delta i och samarbeta i Studio-sessioner och Studio-projekt genom en integration måste du ha minst en Bluebeam-prenumerationsplan av typen Basics.

Om du är Revu 20-användare kan du delta i och samarbeta i Studio-sessioner och Studio-projekt genom en integration, men du kan inte skapa dem via Bluebeam Studio API.

För att skapa Studio-sessioner och Studio-projekt genom en integration måste du uppgradera till någon av Bluebeam-prenumerationsplanerna Core, Complete eller Max.

 

Integrationsutvecklare

Bluebeam Developer Portal för utveckling av integrationer är endast tillgänglig för aktiva kunder, kanalpartners och programvarupartners i regionerna USA, AU, DE, UK och SE. Om du är befinner dig utanför dessa regioner väljer du den som bäst motsvarar dina lokala krav på datahemvist och potentiella överväganden om datalatens.

Det finns regionspecifika bas-URL:er som gäller för alla slutpunkter:

Till exempel blir https://api.bluebeam.com/publicapi/v1/sessions i regionen US https://api.bluebeamstudio.com.au/publicapi/v1/sessions i regionen AU.

Ett 404-fel av typen ”bad request” kan orsakas av ett tokenproblem. Det kan inträffa om ett annat användarkonto, utan åtkomst till Developer Portal, valdes automatiskt på inloggningsskärmen. Den felaktiga token hindrar dig sedan från att logga in. För att lösa problemet måste du se till att du loggar in med rätt konto, som har åtkomst till Developer Portal.

Vi föreslår också att du provar följande felsökningssteg för att åtgärda 404-felet av typen ”bad request”:

- Prova att komma åt Developer Portal i ett inkognitofönster eller en annan webbläsare för att logga in med inloggningsuppgifterna för Developer Portal.

- Töm webbläsarens cacheminne och prova att logga in med inloggningsuppgifterna för Developer Portal.

Om stegen ovan inte löser problemet kan det vara relaterat till single sign-on (SSO)-autentisering. Om din domän använder SSO med en autentiserare som Okta Workforce kan det orsaka en konfigurationskonflikt som resulterar i ett 404-fel av typen ”bad request”. För att lösa problemet ska du se till att lägga till Developer Portal i din licensgrupp. Det löser problemet och möjliggör rätt åtkomst.

1. Du måste inkludera offline_access som en omfattning när du genererar din åtkomsttoken.

2. För begäranden om uppdateringstoken behöver du endast fälten refresh_token och grant_type i brödtexten. Om du lägger till något mer kommer åtgärden att misslyckas.

3. Formatera auktoriseringsrubriken enligt följande:
Authorization Basic {base64 encoded string of client_id:client_secret}

För detaljerad information om API-slutpunkter och de senaste uppdateringarna av integrationsplattformen kan du gå till avsnittet för API-dokumentation i Developer Portal.

Viktig information om Bluebeam Integrationer

 

Viktiga ändringar i Bluebeam Developer Portal

  • Byggde om Bluebeam Developer Portal för att ge utvecklare en snabbare, tydligare och mer självbetjänande upplevelse

  • Förbättrade användargränssnittet för visning av API-dokumentation, inklusive ett nytt Sök-alternativ för att hitta sökordsmatchningar

  • Introducerade en helt ny funktion för ”Testbegäran” som gör att utvecklare kan testa slutpunkter i webbläsaren på olika kodspråk.

  • Förenklade alternativ när en ny applikation skapas

  • Lade till ytterligare programinformation och uppdateringsalternativ i tabellen Mina appar.

  • Effektiviserade registreringsprocessen för användare som har ett aktivt BBID och en Core-, Complete- eller Max -prenumerationsplan.

  • Införde nya arbetsflöden för att skapa applikationer i Sandbox-miljö och skicka till vårt team för publicering i Produktion.

  • Markeringarnas slutpunkter har lämnat beta och är tillgängliga för alla utvecklaranvändare

Viktiga ändringar i Bluebeam Integrations hastighetsbegränsning

Som en del av vårt åtagande att bygga en pålitlig integrationsplattform implementerar vi hastighetsbegränsningar för integrationer från och med den 1 juli 2026. Dessa hastighetsbegränsningar bidrar till att säkerställa att varje partner får konsekvent och pålitlig API-prestanda i takt med att vårt ekosystem växer.

Vad innebär det för dig?

Efter 1 juli 2026 kommer användares förfrågningar som överskrider gränsen att få ett "För många förfrågningar"-fel av typen HTTP 429 och kommer inte att behandlas.

Vad förändras?

Session-slutpunkter

  • GET /publicapi/v1/sessions/*
    - 150 begäranden/minut över alla Session GET-slutpunkter sammanlagt

  • POST/PUT/DELETE /publicapi/v1/sessions/*
    - 50 förfrågningar/minut över alla andra Session-slutpunkter

Projektslutpunkter

  • GET /publicapi/v1/projects/*
    - 150 requests/minute

  • POST/PUT/DELETE /publicapi/v1/projects/*
    - 50 requests/minute

Jobb-slutpunkter

  • GET & PUT /publicapi/v1/jobs/*
    - 100 anrop/minut

Vad kan man göra?

  • Gör en mätning av dina begränsningar med hjälp av hastighetsbegränsningsrubrikerna och justera integrationerna därefter.

  • Ersätt upprepade förfrågningar med Webhooks där det är möjligt för att minska volymen.

Har du frågor? Kontakta oss.

Uppdatera till Bluebeam Studio-projekt Revisions-ID-fält

Den 2 mars 2026 kommer vi att uppdatera fältet RevisionID i API-svar för Studio-projekt. Denna ändring är viktig för support av den övergripande prestandan och långsiktiga tillväxten av Bluebeam Studio.

Bluebeam Studio API ändrar det underliggande värdet för fältet RevisionID till en annan intern identifierare för följande slutpunkter:

Metod

Slutpunkt

HÄMTA

/v1/projects/{projectId}/filer

HÄMTA

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

HÄMTA

/v1/projekt/{projectId}/filer/{fileId}

HÄMTA

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

HÄMTA

/v1/projects/{projectId}/filer/{fileId}/Revisioner

HÄMTA

/v1/projects/{projectId}/filer/{fileId}/revisioner/{id}

Publicera

/v1/projects/{projectId}/filer/{fileId}/Revisioner/{id}/restore

Om du lagrar eller cachar RevisionID internt:

  • Du bör uppdatera alla cachelagrade revisionsdata efter den 2 mars 2026, genom att anropa den nya ändpunkten för revisionslistan för att hämta aktuella värden.

  • Om du inte uppdaterar cachelagrad revisionsdata kan din integration stöta på fel efter den 2 mars 2026.

GET /v1/projects/{projectId}/files

Före

Efter

[{
"$id": "12",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Permission": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": Ja,
"InSession": Nej,
"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": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": ja,
"InSession": nej,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1", "RevisionID": 2
}..]

 

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

Före

Efter

{
"$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,
"Namn": "grid.pdf",
"Sökväg": "/level1/grid.pdf",
"ParentFolderId": 380657776,
"Created": "2025-12-16T23:42:11.39976",
"Permission": "ReadWriteDelete",
"CRC": "90B707AA",
"Size": 3256,
"IsLocked": ja,
"InSession": nej,
"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": "Rutnät.pdf",
"Path": "/level1/grid.pdf",
"ParentFolderId": 380657776,
"Created": "2025-12-16T23:42:11.39976",
"Permission": "ReadWriteDelete",
"CRC": "90B707AA",
"Size": 3256,
"IsLocked": Ja,
"InSession": Nej,
"LockOwnerEmail": "DocusignIntegration@bluebeam.com",
"LockOwnerName": "DocusignIntegration",
"RevisionID": 2
}

 

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

Före

Efter

{
"$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",
"Permission": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": ja,
"InSession": nej,
"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",
"Permission": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": Ja,
"InSession": Nej,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 2
}

 

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

Före

Efter

{
"$id": "1",
"ProjectFiles": [
{
"$id": "2",
"Id": 354537051,
"Name": "SampleDocument.pdf",
"Path": "/DemoFolder/SampleDocument.pdf",
"ParentFolderId": 354537038,
"Created": "2025-04-23T23:57:20.812851",
"Permission": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": Ja,
"InSession": Nej,
"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",
"Behörigheter": "ReadWriteDelete",
"CRC": "6EA99F33",
"Size": 248672,
"IsLocked": Ja,
"InSession": Nej,
"LockOwnerEmail": "bbintegrationsdemo1@bluebeam.com",
"LockOwnerName": "BBIntegrations Demo1",
"RevisionID": 2
}
],
"ProjectFolders": [],
"TotalCount": 1
}

 

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

Före

Efter

{
"$id": "1",
"ProjectFileRevisions": [
{
"$id": "2",
"Id": 705422176,
"kommentar": "",
"CRC": "799548DA",
"OperationType": "Add",
"RevisionNumber": 872381127,
"RevisionRestorable": true,
"Size": 78207,
"Timestamp": "2025-04-23T23:57:22.23021",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"Användarnamn": "BBIntegrations Demo1"
},
{
"$id": "3",
"Id": 705422365,
"Kommentar": "Signerat från DocuSign",
"CRC": "00000000",
"OperationType": "CheckIn",
"RevisionNumber": 705422365,
"RevisionRestorable": Nej,
"Size": 0,
"Timestamp": "2025-04-23T23:59:29.535663",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"Användarnamn": "BBIntegrations Demo1"
}
]
}

{
"$id": "1",
"ProjectFileRevisions": [
{
"$id": "2",
"Id": 1,
"kommentar": "",
"CRC": "799548DA",
"OperationType": "Add",
"RevisionNumber": 1,
"RevisionRestorable": true,
"Size": 78207,
"Timestamp": "2025-04-23T23:57:22.23021",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
},
{
"$id": "3",
"Id": 2,
"Kommentar": "Signerad från DocuSign",
"CRC": "00000000",
"OperationType": "CheckIn",
"RevisionNumber": 2,
"RevisionRestorable": Nej,
"Size": 0,
"Timestamp": "2025-04-23T23:59:29.535663",
"UserEmail": "bbintegrationsdemo1@bluebeam.com",
"UserName": "BBIntegrations Demo1"
}
]
}

 

GET v1/projekt/{projectId}/filer/{fileId}/revisioner/{id}

Före

Efter

{
"$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",
"RevisionNumber": 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"
}

Slutpunkter som accepterar RevisionID som inmatning:

Metod

Slutpunkt

Beskrivning

HÄMTA

/v1/projects/{projectId}/filer/{fileId}/revisioner/{id}

Hämta revisionsmetadata

Publicera

/v1/projects/{projectId}/filer/{fileId}/Revisioner/{id}/restore

Återskapa fil till revision.

Uppdateringar av Bluebeam API-licensåtkomst

Uppgradera till Bluebeam Core eller Complete för att bibehålla Skapa-funktionalitet genom en integration

Som en del av vårt åtagande att erbjuda bästa möjliga upplevelse genom Bluebeam Studio API har vi avvecklat licensintegrationerättigheterna den 20 februari 2026.

Vad detta betyder:

  • Integrationsanvändare på Revu 20 kan delta i och samarbeta i Studio-sessioner och Studio-projekt via en integration, men kan inte skapa dem via en integration efter den 20 februari 2026.

  • För att fortsätta skapa Studio-sessioner och -projekt via en integration måste användare uppgradera till en Bluebeam Core eller Complete prenumeration från och med den 20 februari 2026.

Läs mer om Bluebeam prenumerationsplaner här: Prenumerationsfunktioner.

Markeringar API – Förbättringar

Versionsåtkomst: Beta

  • Bygger vidare på Markeringar API V1, släppt 2025, till nya funktioner listade nedan.

  • Lägger till läsåtkomst till ytterligare fält i markeringslistan för ett rikare markeringssammanhang.

  • Ger tillgång till ändringshistorik för markeringar

  • Släpps som betaversion; funktionalitet och täckning kan komma att utvecklas

  • Uppdaterad Developer Portal-dokumentation är nu tillgänglig

komma åt markeringsdata

Markeringar API v1

Markeringar-API v2

Markeringar:
markupID | documentId

- sessionId

SKRIVSKYDDAT

SKRIVSKYDDAT

e-post
t.ex., example@gmail.com

SKRIVSKYDDAT

SKRIVSKYDDAT

displayName
t.ex., test

SKRIVSKYDDAT

SKRIVSKYDDAT


Skriv (t.ex. Linje)

SKRIVSKYDDAT

SKRIVSKYDDAT

Ämne
(t.ex. Pil)

SKRIVSKYDDAT

SKRIVSKYDDAT

Ämne

SKRIVSKYDDAT

SKRIVSKYDDAT

Skapad

SKRIVSKYDDAT

SKRIVSKYDDAT

Ändrad

SKRIVSKYDDAT

SKRIVSKYDDAT

Status

SKRIVSKYDDAT

SKRIVSKYDDAT

Lås

X

SKRIVSKYDDAT

Sidnummer

X

SKRIVSKYDDAT

Comments

X

SKRIVSKYDDAT

Lager

X

SKRIVSKYDDAT

Etikett

X

SKRIVSKYDDAT

Mätningsdata

X

SKRIVSKYDDAT

Anpassad/anpassade kolumn(er)

X

SKRIVSKYDDAT

Geometri

X

SKRIVSKYDDAT

Anpassade statusar

X

SKRIVSKYDDAT

Status Författare

X

X

Status uppdaterad

X

X

Författare*

X

SKRIVSKYDDAT

Stämpel

SKRIVSKYDDAT

SKRIVSKYDDAT

Resurser

Revu 21

Bluebeam-integrationer

Bluebeam-integrationer

Använd dessa resurser för att lära dig mer om vad Bluebeam-integrationer är, hur du får tillgång till integrationerna och hur du utvecklar privata eller offentliga integrationer mellan Bluebeam och programvara från tredje part.