> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autentisering

> Skapa en API-nyckel och autentisera dina begäranden.

> [!NOTE]
>
> GetQR:s API är i beta och finns för utvalda arbetsytor. Detaljer kan ändras före den allmänna lanseringen.

GetQR:s API autentiserar varje begäran med kontots API-nyckel. Varje användare har en nyckel, och den agerar som du i en arbetsyta.

## Innan du börjar

* Du är arbetsytans ägare eller redigerare. Läsare kan inte skapa eller använda en API-nyckel.
* Arbetsytans ägare har en aktiv prenumeration.

## Skapa din API-nyckel

**1. Öppna kontoinställningarna**

Öppna kontoinställningarna och gå till **API**.

**2. Generera nyckeln**

Klicka på **Generate API key**.

**3. Kopiera nyckeln**

Visa nyckeln och kopiera den. Nycklar börjar med `sk_live_`.

Du kan visa och kopiera nyckeln igen när som helst. Inställningarna visar också när nyckeln skapades och när den senast användes.

## Autentisera begäranden

Skicka nyckeln som Bearer-token i `Authorization`-huvudet i varje begäran:

```bash theme={null}
curl "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer sk_live_..."
```

| Problem | Svar |
| - | - |
| Inget `Authorization`-huvud | `401 unauthorized`: ”Missing Authorization header.” |
| Huvudet börjar inte med `Bearer ` | `400 bad_request`: ”Misconfigured authorization header. Did you forget to add 'Bearer '?” |
| Okänd eller omgenererad nyckel | `401 unauthorized`: ”Unauthorized: Invalid API key.” |
| Din roll är läsare | `403 forbidden`: ”API access is not available for this role.” |
| Arbetsytans ägare har ingen aktiv prenumeration | `403 forbidden`: ”Access denied: This account does not have an active subscription.” |
| API:et är inte aktiverat för din arbetsyta | `404 not_found`: ”This endpoint is not available.” |

[Statuskontrollen](https://docs.getqr.com/sv/api/endpoints/health.md) är den enda slutpunkten som fungerar utan nyckel.

## Åtkomst och roller

* **Roller.** Bara arbetsytans ägare och redigerare kan skapa och använda en API-nyckel. Läsare kan inte det.
* **Arbetsyta.** Varje nyckel hör till en enda arbetsyta, och varje begäran körs i den arbetsytan. Du behöver inte skicka något arbetsyte-id.
* **Löpande kontroller.** Åtkomsten kontrolleras vid varje begäran mot din nuvarande roll och arbetsytans ägares prenumeration. Din egen prenumeration spelar ingen roll. Om din roll ändras till läsare eller ägarens prenumeration upphör returnerar begäranden `403` tills åtkomsten är återställd. Du behöver ingen ny nyckel.
* **Borttagning.** Om du tas bort från arbetsytan raderas din API-nyckel. Om du läggs till igen genererar du en ny nyckel.

## Generera om nyckeln

Generera om nyckeln om den läcker eller om någon som inte borde ha den får tillgång till den.

> [!WARNING]
>
> Den nuvarande nyckeln slutar fungera direkt. Appar och integrationer som använder den slutar fungera tills du uppdaterar dem med den nya nyckeln.

**1. Klicka på Regenerate**

Gå till **API** i kontoinställningarna och klicka på **Regenerate**.

**2. Bekräfta**

Klicka på **Regenerate key**.

**3. Uppdatera dina appar**

Kopiera den nya nyckeln och ersätt den gamla överallt där du använder den.

## Skydda din nyckel

Behandla nyckeln som ett lösenord: alla som har den kan skapa, ändra och ta bort QR-koder i din arbetsyta.

* Spara den i en miljövariabel eller en hemlighetshanterare, inte i källkoden.
* Anropa API:et bara från din server. Lägg aldrig nyckeln i en webbplats, en mobilapp eller något annat som användare kan granska.
* Dela den bara med utvecklare som behöver den.
* Generera om den så fort du misstänker att den har läckt.

## Vanliga problem

> [accordion] Jag får 401 med en nyckel som brukade fungera
>
> Nyckeln har genererats om, eller så har du tagits bort från arbetsytan och nyckeln har raderats. Kopiera den aktuella nyckeln från kontoinställningarna eller generera en ny.

> [accordion] Jag får 403 på varje begäran
>
> Kontrollera att din roll är ägare eller redigerare och att arbetsytans ägare har en aktiv prenumeration. Nyckeln fungerar igen så fort åtkomsten är återställd.

> [accordion] Jag får 404 "This endpoint is not available."
>
> API:et är i beta och är inte aktiverat för din arbetsyta än.

> [accordion] Jag ser inte API-inställningarna
>
> De visas bara för arbetsytans ägare och redigerare, och bara i arbetsytor där API:et är aktiverat.

## Nästa steg

> [card] [Introduktion till API:et](https://docs.getqr.com/sv/api/introduction.md)

> [card] [Fel](https://docs.getqr.com/sv/api/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.