> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cxplanner.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Opsæt API-adgang

Firmaets API-område lader brugere med rollen **Admin** oprette API-nøgler og OAuth-klienter, så eksterne systemer, scripts eller interne værktøjer kan kalde CxPlanner over HTTPS. Det bruges til integrationer, der skal have læse-, skrive- eller global projektadgang.

Se [Tilføj en API-bruger til et projekt](https://help.cxplanner.com/en-us/article/add-an-api-user-to-a-project-8mstyy/), når API-brugeren skal knyttes til et projekt.

* Din rolle skal være virksomheds-**Admin**.
* Du finder menuen ved profilikonet, **Firmaprofil**, **API**.
* Her opretter eller tilbagekalder du legitimationsoplysninger, der kan tilgå firma- og projektdata.

|| Kun brugere med virksomhedsrollen Admin kan åbne og administrere API-området.

|| Modulet med API-nøgler er en Enterprise-funktion og skal være slået til for firmaet.

Hemmeligheder vises kun én gang. Integrationer, der ikke er globale, kræver, at API-brugeren er medlem af projektet. Global adgang dækker alle firmaets projekter uden opsætning pr. projekt.
## Sådan opsætter du API-adgang
### Åbn siden med API-nøgler
1. Log ind i CxPlanner, og klik på dit profilikon.
2. Gå til **Firmaprofil**.
3. Klik på **API**.

![Firma API](https://storage.crisp.chat/users/helpdesk/website/-/e/a/2/c/ea2cfd7bb6130800/image_pltsip.png)

### Opret en ny API-nøgle eller OAuth-klient
1. Klik på **Generer API-nøgle** nederst på skærmen.
2. I **Create new API key** skriver du **API-navn**.
3. Vælg **API type**.
4. Vælg **API scope**.
5. Klik på **Gem**.

![Opret en API Nøgle](https://storage.crisp.chat/users/helpdesk/website/-/e/a/2/c/ea2cfd7bb6130800/image_udin3i.png)


### Gem legitimationsoplysningerne sikkert
1. Se, hvilken type der blev oprettet.
2. Ved en statisk API-nøgle kopierer du hemmeligheden fra dialogen.
3. Ved OAuth-typer kopierer du **Client ID** og **Client Secret**.
4. Gem dem i jeres hemmelighedsstyring, før du lukker dialogen.

||| Hemmeligheder vises kun én gang. Hvis de går tabt, skal du oprette en ny nøgle eller klient og slette den gamle.

### Administrer eksisterende legitimationsoplysninger
1. Åbn tabellen på siden med API-nøgler.
2. Gennemgå **Navn**, **Omfang**, **Type**, **Sidst brugt** og **Brugt (antal)**.
3. Find den nøgle eller klient, der skal fjernes.
4. Klik på **Slet**.
5. Bekræft i dialogen **Delete API key**.

![Administrer API-nøgler](https://storage.crisp.chat/users/helpdesk/website/-/e/a/2/c/ea2cfd7bb6130800/image_1rwdj7i.png)


### Giv projektadgang til API-brugere med begrænset omfang
1. Bekræft, at integrationen bruger et omfang, der ikke er globalt.
2. Find API-brugeren (\`apiservice+\<unique_id>@cxplanner.com\`).
3. Åbn hvert relevant projekt.
4. Tilføj API-brugeren med en passende projektrolle.
5. Vælg en rolle, der matcher det, integrationen skal kunne.

## Resultat: API-adgang
### Godkendelsestyper
| Godkendelsestype | Anvendelse | Sådan virker den | Typisk brug |
| ---- | ---- | ---- | ---- |
| **Statisk API-nøgle** | System til system | Send nøglen i headeren | Enkle integrationer |
| **OAuth (API-bruger)** | System til system | Brug client_id og client_secret til at hente Bearer-tokens (client_credentials) | Almindelige sikre integrationer |
| **OAuth PKCE (individuel bruger)** | Delegeret af en bruger | Brugeren logger ind og godkender adgangen, og API'en bruger derefter et Bearer-token | Integrationer på vegne af en bruger |

### Omfang
| Omfang (opret-dialog) | Etiket i tabellen | Adgang |
| ---- | ---- | ---- |
| Developer READ API | READ ONLY | Kun læseadgang |
| Developer READ-WRITE API | READ & WRITE | Læse- og skriveadgang |
| Developer Global API | GLOBAL | Adgang til alle firmaets projekter |

### Regler for projektadgang
| Omfangstype | Projektadgang kræves | Resultat |
| ---- | ---- | ---- |
| READ API | Ja | Kan læse data i de tildelte projekter |
| READ-WRITE API | Ja | Kan læse og skrive i de tildelte projekter |
| GLOBAL | Nej | Adgang til alle firmaets projekter |
Statiske API-nøgler udløber ikke. Bearer-tokens holder i omkring 3600 sekunder og har et refresh-token.

## Fejlfinding: opsæt API-adgang
| Problem | Årsag | Løsning |
| ---- | ---- | ---- |
| Menuen **API** mangler | API-modulet er ikke slået til, eller rollen er under **Admin** | Bed en virksomheds-**Admin** om at slå modulet med API-nøgler til, eller om at hæve din rolle til **Admin** |
| **Generer API-nøgle** kan ikke klikkes | API-funktionen er ikke slået til for firmaet | Bed en virksomheds-**Admin** eller CxPlanner Support om at slå modulet med API-nøgler til |
| Fejl ved åbning af API-siden | Kontoen er ikke virksomheds-**Admin** | Log ind med en konto, der er virksomheds-**Admin** |
| Integrationen kan ikke tilgå et projekt | API-brugeren er ikke tilføjet, eller omfanget er forkert | Tilføj API-brugeren til projektet, og bekræft nøglens omfang |
| API-hemmeligheden er væk | Hemmeligheder vises kun én gang | Opret en ny nøgle, opdater integrationerne, og slet den gamle nøgle |
| Integrationen kan ikke skrive data | Der er valgt et omfang med kun læsning | Opret en nøgle med omfanget Developer READ-WRITE API |
| Integrationen kan ikke tilgå alle projekter | Der bruges ikke globalt omfang | Opret en nøgle med omfanget Developer Global API, eller tilføj API-brugeren til hvert projekt |