Den här artikeln visar hur du konfigurerar API-identiteter för Dalux Build API.
API-identiteter ger ett sätt att få tillgång till Dalux Build API med specifika användarrättigheter.
Genom att skapa en API-identitet kan du specificera nivån på åtkomst till systemet, oavsett om det är tillgång till all företagsdata över alla projekt eller begränsad tillgång till vissa grupper på specifika projekt.
Om du vill lära dig mer om Dalux API:er, läs den här artikeln: Dalux API.
Observera
API-identiteter kommer att ersätta den nuvarande API-nyckelfunktionen. Var medveten om att alla nuvarande API-nycklar på företagsprofilen kommer att upphöra den 28 februari 2026.
Alla API-nycklar måste ersättas med API-identiteter före detta datum.
Hur man konfigurerar API-identiteter
API-identiteter konfigureras i företagsprofilen.
Användarrättigheter
Endast företagsadministratörer kan ställa in, redigera eller ta bort API-identiteter.
För att skapa en API-identitet, gå till Företagsprofil
Inställningar
'API-identiteter'.
I API-identitetsfönstret kan du skapa nya identiteter och hantera befintliga.
Du kan skapa flera identiteter för att hantera åtkomstnivåer efter behov. För att skapa en ny API-identitet, klicka på Skapa.
- Namn - Namnet på API-identiteten som visas i gränssnittet. Vi föreslår att välja ett namn som är både beskrivande och tydligt.
- Email - E-postadressen som anges här ansvarar för att validera API:t via ett bekräftelsemejl
- Företag - Namnet på företaget som API-identiteten gäller för (metadata)
- Företagsrättigheter - Ange endast denna behörighet när API-identiteten ska ha tillgång till data i alla dina projekt. Företagsbehörigheterna motsvarar rollerna i företagsprofilen (Företagsadministratör och Företagsobservatör). Detta kan ändras efter att identiteten har skapats.
- Beskrivning - En kort beskrivning som innehåller detaljer om API-identiteten, såsom åtkomstomfattning, kontaktinformation eller annan relevant information.
Efter att du har angett nödvändig information och godkänt API-identitetens villkor och bestämmelser, skickas ett verifieringsmejl till den angivna e-postadressen. Vid behov kan e-posten skickas om. Du kan inte generera en API-nyckel förrän identiteten har verifierats.
Efter att ha verifierat API-identiteten kan du lägga till projektinställningar som möjliggör mer specifik projektåtkomst. Detta steg är endast nödvändigt om du inte har valt någon företagsåtkomst.
Klicka på 'Lägg till projekt' för att fortsätta. Välj sedan projektet och lägg till användargrupp(er).
De valda användargruppernas rättigheter styr vad API-identiteten har tillgång till på projektet.
När du är klar, klicka på 'Lägg till'.
Nu kan du lägga till en API-nyckel till API-identiteten. Klicka på 'Lägg till API-nyckel' för att fortsätta. När du lägger till en API-nyckel måste du ange giltighetstiden.
En API-nyckel kommer nu att genereras. Kopiera nyckeln och bekräfta att den har kopierats, klicka sedan på 'OK'.
VIKTIGT
API-nyckeln måste kopieras och sparas. Du kommer inte kunna komma åt API-nyckeln efter att fönstret har stängts.
API-identiteten kan nu användas med Dalux Build API.