Centre d'intégration Bluebeam

• Nous avons reconstruit le Bluebeam Developer Portal afin d'offrir aux développeurs une expérience plus rapide, plus claire et plus autonome.

• Interface utilisateur améliorée pour l'affichage de la documentation API, incluant une nouvelle option pour Rechercher et trouver des mots-clés correspondants.

• Introduction d'une toute nouvelle fonctionnalité « Test Request » permettant aux développeurs de tester les points de terminaison directement dans le navigateur, dans différents langages de codage

• Options simplifiées lors de la création d'une nouvelle application

• Ajout de détails d'application supplémentaires et d'options de mise à jour au tableau Mes applications.

• Simplifié le processus de prise en main pour les utilisateurs disposant d'un BBID actif et d'une formule Core, Complete ou Max

• De nouveaux workflows ont été introduits pour la création d'applications dans un environnement Sandbox et leur soumission à notre équipe pour publication en Production.

• Les points de terminaison des annotations ne sont plus en version bêta et sont disponibles pour tous les utilisateurs développeurs

Dans le cadre de notre engagement à construire une plateforme d'intégrations fiable, nous mettons en œuvre des limites de taux d'intégration à compter du 1er juillet 2026. Ces limites de taux contribuent à garantir que chaque partenaire reçoive des performances d'API cohérentes et fiables à mesure que notre écosystème se développe.

Qu’est-ce que cela signifie pour vous ?

Après le 1er juillet 2026, les requêtes utilisateur qui dépassent la limite recevront une "Trop de requêtes" erreur HTTP 429 et ne seront pas traitées.

Ce qui change ?

Points de terminaison de session

• GET /publicapi/v1/sessions/*
  – 150 requêtes/minute sur tous les points de terminaison GET de Session combinés

• POST/PUT/DELETE /publicapi/v1/sessions/*
  — 50 requêtes/minute sur tous les autres points de terminaison de Session

Points de terminaison de projet

• GET /publicapi/v1/projects/*
  - 150 requêtes/minute

• POST/PUT/DELETE /publicapi/v1/projects/*
  – 50 requêtes/minute

Points de terminaison des tâches

• GET & PUT /publicapi/v1/jobs/*
  – 100 requêtes par minute

Que pouvez-vous faire ?

• Mesurez vos limites de débit à l'aide des en-têtes de limitation de débit et ajustez les intégrations en conséquence.

• Remplacer les schémas d'interrogation par des Webhooks dans la mesure du possible afin de réduire le volume des demandes.

Des questions ? Nous contacter.

Le 2 mars 2026, nous mettrons à jour le chantier RevisionID dans les réponses de l'API des Projets Studio. Ce changement est important pour l'assistance de la performance globale et la croissance à long terme de Bluebeam Studio.

L'API Bluebeam Studio modifie la valeur sous-jacente du chantier ID de révision en un identifiant interne différent pour les points de terminaison suivants :

Si vous stockez ou mettez en cache l'ID de révision en interne :

• Il convient d'actualiser toutes les données de révision mises en cache après le 2 mars 2026 en appelant le nouveau point de terminaison de la liste des révisions pour récupérer les valeurs actuelles.

• Si vous n’actualisez pas les données de révision mises en cache, votre intégration peut rencontrer des erreurs après le 2 mars 2026.

Exemples de réponse

GET /v1/projects/{projectId}/files

Avant

Après

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

 

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

Avant

Après

{ "$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", "Autorisations": "ReadWriteDelete", "CRC": "90B707AA", "Size": 3256, "IsLocked": Oui, "InSession": Non, "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": "grille.pdf", "Path": "/level1/grid.pdf", "ParentFolderId": 380657776, "Created": "2025-12-16T23:42:11.39976", "Autorisations": "ReadWriteDelete", "CRC": "90B707AA", "Size": 3256, "IsLocked": Oui, "InSession": Non, "LockOwnerEmail": "DocusignIntegration@bluebeam.com", "LockOwnerName": "DocusignIntegration", "RevisionID": 2 }

 

GET /v1/projets/{projectId}/fichiers/{fileId}

Avant

Après

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

 

GET /v1/projects/{projectId}/folders/{id}/éléments

Avant

Après

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

 

GET /v1/projects/{projectId}/files/{fileId}/révisions

Avant

Après

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

{ "$id": "1", "ProjectFileRevisions": [ { "$id": "2", "Id": 1, "commentaire": "", "CRC": "799548DA", "OperationType": "Add", "RevisionNumber": 1, "RevisionRestorable": Oui, "Size": 78207, "Timestamp": "2025-04-23T23:57:22.23021", "UserEmail": "bbintegrationsdemo1@bluebeam.com", "UserName": "BBIntegrations Demo1" }, { "$id": "3", "Id": 2, "commentaire": "Signé depuis DocuSign", "CRC": "00000000", "OperationType": "CheckIn", "RevisionNumber": 2, "RevisionRestorable": Non, "Size": 0, "Timestamp": "2025-04-23T23:59:29.535663", "UserEmail": "bbintegrationsdemo1@bluebeam.com", "UserName": "BBIntegrations Demo1" } ] }

 

GET v1/projets/{projectId}/fichiers/{fileId}/révisions/{id}

Avant

Après

{ "$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, « Commentaire » : « », « CRC » : « 799548DA », « OperationType » : « Add », « RévisionNuméro » : 705422365, « Révision Restaurable » : Oui, « Taille » : 78207, « Horodatage » : « 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, "Commentaire": "", "CRC": "799548DA", "OperationType": "Add", "Numéro de révision": 1, "Révision restaurable": "Oui", "Size": 78207, "Timestamp": "2025-04-23T23:57:22.23021", "UserEmail": "bbintegrationsdemo1@bluebeam.com", "Nom d'utilisateur": "BBIntegrations Demo1" }

Points de terminaison acceptant l'ID de révision comme entrée :

Mettez à niveau vers Bluebeam Core ou Complete pour maintenir la fonctionnalité de création via une intégration

Dans le cadre de notre engagement à offrir la meilleure expérience possible via l'API Bluebeam Studio, nous avons mis fin aux droits d'intégration des licences le 20 février 2026.

Ce que cela signifie :

• Les utilisateurs d'intégration sur Revu 20 peuvent participer et collaborer à des Sessions Studio et des Projets via une intégration, mais ne peuvent pas effectuer de Création via une intégration après le 20 février 2026.

• Pour continuer à créer des Sessions Studio et des projets via une intégration, les utilisateurs doivent passer à une formule d'abonnement Bluebeam Core ou Complete à compter du 20 février 2026.

En savoir plus sur les formules d'abonnement Bluebeam ici : Fonctionnalités de l'abonnement.

Accès à la version : bêta

• S'appuie sur l'API d'annotations V1, publiée en 2025, pour de nouvelles fonctionnalités listées ci-dessous.

• Ajoute un accès en lecture à des chantiers supplémentaires de la Liste des annotations pour un contexte d’annotations plus riche

• Donne accès à l'historique des modifications des annotations

• Publié en version bêta ; les fonctionnalités et la couverture peuvent évoluer

• La documentation mise à jour du Developer Portal est désormais disponible