Denne artikel vil vise dig, hvordan du opsætter API-identiteter til Dalux Build API.
API-identiteter giver en måde at få adgang til Dalux Build API med specifikke brugerrettigheder.
Ved at oprette en API-identitet kan du angive adgangsniveauet til systemet, hvad enten det er adgang til alle firmadata på tværs af alle projekter eller begrænset adgang til bestemte grupper på særlige projekter.
Hvis du vil lære mere om Dalux API'er, læs denne artikel: Dalux API.
Bemærk
API-identiteter vil erstatte den nuværende API-nøglefunktion. Vær opmærksom på, at alle nuværende API-nøgler på firmaprofilen udløber efter 28. februar 2026.
Alle API-nøgler skal erstattes med API-identiteter inden denne dato.
Sådan opsætter du API-identiteter
API-identiteter opsættes i firmaprofilen.
Brugerrettigheder
Kun firmaadministrationer kan opsætte, redigere eller fjerne API-identiteter.
For at oprette en API-identitet, gå til Firmaprofil
Opsætning
'API-identiteter'.
I vinduet for API-identiteter kan du oprette nye identiteter og administrere eksisterende.
Du kan oprette flere identiteter for at administrere adgangsniveauer efter behov. For at opsætte en ny API-identitet, klik på Opret ny.
- Navn - Navnet på API-identiteten, der vises i grænsefladen. Vi foreslår at vælge et navn, der både er beskrivende og klart.
- Email - Den indtastede email er ansvarlig for at validere API'en via en bekræftelsesmail
- Firma - Navnet på det firma, som API-identiteten er til (metadata)
- Firma brugerrettigheder - Angiv kun denne brugerrettighed, når API-identiteten skal have adgang til data på tværs af alle dine projekter. Firma brugerrettigheder matcher dem fra firmaprofil-rollerne (firmaadministrator og firmaobservatør). Dette kan ændres efter identiteten er oprettet.
- Beskrivelse - En kort beskrivelse, der indeholder detaljer om API-identiteten, som f.eks. adgangsomfang, kontaktinfo eller andre relevante data.
Efter at du har indtastet de nødvendige oplysninger og accepteret API-identitetens vilkår og betingelser, vil der blive sendt en verifikationsmail til den oplyste e-mailadresse. Hvis nødvendigt kan emailen sendes igen. Du kan ikke generere en API-nøgle, før identiteten er blevet verificeret.
Efter at have verificeret API-identiteten, kan du tilføje projektopsætninger, som tillader mere specifik projektadgang. Dette trin er kun nødvendigt, hvis du ikke har valgt nogen firmaadgang.
Klik på 'Tilføj projekt' for at fortsætte. Vælg derefter projektet, og tilføj brugergruppen(e).
De valgte brugergruppers brugerrettigheder kontrollerer, hvad API-identiteten har adgang til på projektet.
Når du er færdig, klik på 'Tilføj'.
Nu kan du tilføje en API-nøgle til API-identiteten. Klik på 'Tilføj API-nøgle' for at fortsætte. Når en API-nøgle tilføjes, skal du angive dens gyldighedsperiode.
En API-nøgle vil nu blive genereret. Kopiér nøglen og bekræft, at nøglen er kopieret, klik derefter på 'OK'.
VIGTIGT
API-nøglen skal kopieres og gemmes. Du vil ikke være i stand til at få adgang til API-nøglen efter vinduet er lukket.
API-identiteten kan nu bruges med Dalux Build API.