Kom godt i gang i Bluebeam Developer Portal

Bluebeam API er RESTful og har i øjeblikket to kategorier af slutpunkter:

• Godkendelse

• Studio

Godkendelse

Nogle noter på højt niveau om, hvordan vi håndterer godkendelse:

• Godkendelse med OAuth 2.0

  • Alle API-kald foretages i en brugerkontekst. Ved at godkende med OAuth giver en bruger din app tilladelse til at få adgang til sine data og lave API-anmodninger på sine vegne.

• Alle anmodninger og svartekster skal være JSON-formateret. Indstil Content-Type: application/json-overskriften på alle anmodninger, der har brødtekst.

• API-kald skal foretages over HTTPS.

• Se vores Authentication Guide for at begynde at konfigurere OAuth 2.0 i din app.

Studio

Studio er vores samarbejdsplatform i skyen med direkte forbindelse til vores flagskibsapplikation til computere: Bluebeam Revu. Vores Studio-slutpunkter åbner op for kommunikationslinjer for problemfri integration mellem Studio og dine systemer.

Du kan generelt betragte de funktioner, der tilbydes af Studio API, som det samme sæt funktionalitet, som en bruger ville få via Studio GUI i Revu.

Du kan få mere at vide om Studio på vores side med ofte stillede spørgsmål om Studio.

For at gøre tingene hurtigere anbefaler vi at bruge en app, der hedder Postman. Sådan gør du:

1. Opret en BBID-konto, hvis du ikke allerede har gjort det.

2. Gå til developers.bluebeam.com, og log ind.

3. Tilmeld dig for at få adgang.

   1. Gå til Mine apps, og klik på Anmod om adgang.

   2. Udfyld formularen for anmodning om adgang.

   Bemærkning til tilskudstype:
   Markérkun felterne ved siden af:
   • Autorisationskode
   • Opdater token

   3. Omdirigerings-uri: brug https://oauth.pstmn.io/v1/callback

   4. Vælg Anmodning for at indsende formularen.
      

   Godkendelsesmail
   Når du har valgt Anmodning, modtager du en e-mail fra MuleSoft med emnet: "Ansøgningsregistrering godkendt" – ignorer venligst. Det er en anden uønsket bivirkning ved at bruge vores færdige løsning.
   

4. Få legitimationsoplysninger. Nu bør du se din nyligt registrerede App på listen (hvis du ikke kan se den, skal du opdatere din browser). Hold markøren over tasten for at få dine legitimationsoplysninger.

   
   

5. Få et adgangstoken via Postman.

   1. Få adgang til Postman via deres stationære app eller browser, og opret en gratis konto.

   2. Her er et script, som du kan importere til Postman. I Postman skal du gå til Filer > Importer og indsætte scriptet.

   3. For at få et access_token i Postman skal du vælge samlingen Bluebeam API (Script xxx).

   4. Gå til fanen Autorisation, og udskift de orange variabler {{client_id}} og {{client_secret}}med det klient-id og den hemmelighed, som du har modtaget i Mine apps.

   5. Rul ned til bunden,og klik på Hent nyt adgangstoken .
      
      

   6. Log på med dit BBID, og klik på Tillad adgang, når du bliver bedt om det. Du vil blive præsenteret for et token, som du kan bruge i Postman, vores API-dokumenter eller din egen kode.

Her er en trinvis proces til at migrere en eksisterende integration til vores nye platform.

1. Opret en BBID-konto, hvis du ikke allerede har gjort det.

2. Gå til developers.bluebeam.com, og log ind.

3. Registrer en ny app.

   1. Gå til Mine apps, og vælg Anmod om adgang.

   2. Udfyld formularen for anmodning om adgang.

      Bemærkning til tilskudstype:

      Markérkun felterne ved siden af:

      • Autorisationskode
      • Opdater token

   3. Vælg Anmodning for at indsende formularen.
      

4. Få legitimationsoplysninger. Nu bør du se din nyligt registrerede App på listen. Hold markøren over tasten for at få dine legitimationsoplysninger.

   
   

5. Opdater din eksisterende integration med de nye API-ruter til godkendelse og Studio-slutpunkter, der er anført nedenfor.
   

   Servere i USA
   Miljø	Oprindelig basisrute	Ny basisrute
   Auth – Production (US)	https://authserver.bluebeam.com/auth/oauth/authorize	https://api.bluebeam.com/oauth2/authorize
   Auth – Production (US)	https://authserver.bluebeam.com/auth/token	https://api.bluebeam.com/oauth2/token
   Studio – Produktion (USA)	https://studioapi.bluebeam.com:443/publicapi/v1	https://api.bluebeam.com/publicapi/v1

6. Alle steder, hvor du har konfigureret dit tidligere klient-ID og din klienthemmelighed i din integration, skal du erstatte dem med dit nye klient-ID og din nye hemmelighed.

7. I dine API-kald skal du tilføje en overskrift kaldet "client_id" med værdien af dit nye Client ID. Dette er påkrævet for alle forespørgsler, der rammer den nye platform.

   Bemærkning
   Vi arbejder stadig på at gøre vores fejlmeddelelser mere præcise og meningsfulde, men i mellemtiden, hvis du sender din forespørgsel uden "client_id"-headeren, får du vist en fejlmeddelelse som denne:
   

   copy

   1
   2
   3
   {
       "msg": "Intern Server Error"
   }

8. Vores nye platform håndterer godkendelse lidt anderledes end vores gamle platform, så vi anbefaler at gennemgå vores nye godkendelsesguide. To bemærkelsesværdige ændringer:

   • Vi har introduceret et område for offlineadgang til opdateringstokener (se trin 1 i godkendelsesvejledningen).

   • Vores token-slutpunktssvar er ændret (se eksempler på svar i Authentication Guide).

9. Hvis alt er konfigureret korrekt, bør du modtage et svar, der er identisk med det tidligere Studio API's svar for alle Studio-slutpunkter.
   Hvis du for eksempel anmodede om en liste over Studio-projekter, ville dit svar se nogenlunde således ud:
   

   copy

   1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
   {
     "$id": "1"
     "Projects": [
       {
         "$id": "2",
         "Id": "385-509-537",
         "Guid": "Mzu1D6xhLE2bE0y2F4ozfQ",
         "Name": "Testprojektnavn",
         "Restricted": true,
         "Created": "2024-02-29T17:40:58.043",
         "OwnerNameIdentifier": "e149e277-3052-4f3e-a376-29fc6c5aa76c",
         ": "Owjneremail" @bluebeam.com"
       }
     ]
   }

10. Du gjorde det! Test din app, og fortæl os, hvis du støder på problemer.