> ## 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.

# Introduksjon til API-et

> Administrer QR-koder, maler, analyse og rapporter fra din egen kode.

> [!NOTE]
>
> GetQR API-et er i beta og er tilgjengelig for utvalgte arbeidsområder. Detaljer kan endres før den generelle lanseringen.

GetQR API-et er et REST-API for det du gjør i dashbordet: opprett og oppdater QR-koder, last ned bildene deres, les skanneanalyse og eksporter rapporter. Autentiser deg med API-nøkkelen til kontoen din, og kall versjonerte endepunkter under `/api/v1`.

## Dette kan du gjøre

> [card] [QR-koder](https://docs.getqr.com/no/api/endpoints/qr-codes.md)
>
> Opprett, vis, oppdater, sett på pause, dupliser, slett og last ned QR-koder.

> [card] [Analyse](https://docs.getqr.com/no/api/endpoints/analytics.md)
>
> Totalt antall skanninger og oppdelinger for én QR-kode eller hele arbeidsområdet.

> [card] [Rapporter](https://docs.getqr.com/no/api/endpoints/reports.md)
>
> Eksporter en enkeltstående rapport, eller planlegg gjentakende rapporter på e-post.

> [card] [Maler](https://docs.getqr.com/no/api/endpoints/templates.md)
>
> Lagre design og bruk dem på nye QR-koder.

> [card] [Masseopprettelse av QR-koder](https://docs.getqr.com/no/api/endpoints/bulk-qr-creations.md)
>
> Opprett opptil 100 QR-koder på én gang fra JSON eller en CSV-fil.

> [card] [Filer](https://docs.getqr.com/no/api/endpoints/files.md)
>
> Last opp PDF-er, bilder, videoer og logoer til QR-kodene dine.

> [card] [Statussjekk](https://docs.getqr.com/no/api/endpoints/health.md)
>
> Sjekk at API-et er oppe. Krever ingen API-nøkkel.

## Veiledninger

> [card] [QR-kodedata per type](https://docs.getqr.com/no/api/guides/qr-types.md)
>
> Dataformatet for hver av de 16 QR-typene.

> [card] [Tilpasning](https://docs.getqr.com/no/api/guides/customization.md)
>
> Prikkstiler, hjørner, farger, rammer og logoer.

> [card] [Tilgangsregler](https://docs.getqr.com/no/api/guides/access-rules.md)
>
> Tidsplaner, skannegrenser, passord, pause og sletting.

## Basis-URL

Alle endepunkter ligger under én basis-URL:

```text theme={null}
https://getqr.com/api/v1
```

## Versjonering

API-versjonen er en del av banen: hvert endepunkt ligger under `/api/v1/`.

* Endringer som bryter kompatibiliteten, kommer under et nytt versjonsprefiks, for eksempel `/api/v2/`, og `/api/v1/` fortsetter å fungere.
* Tillegg, som nye valgfrie felt eller nye endepunkter, kan komme innenfor v1. Ignorer felt i svaret som koden din ikke kjenner igjen.

## Hurtigstart

**1. Hent API-nøkkelen din**

Generer eller vis nøkkelen din i kontoinnstillingene. Se [Autentisering](https://docs.getqr.com/no/api/authentication.md).

**2. Sjekk at API-et kan nås**

```bash theme={null}
curl https://getqr.com/api/v1/health
```

Svaret er `{ "status": "ok", "version": "v1" }`.

**3. Opprett din første QR-kode**

```bash theme={null}
curl -X POST "https://getqr.com/api/v1/qrs" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-qr-0001" \
  -d '{
    "qrType": "website",
    "data": "https://example.com",
    "title": "Landing page"
  }'
```

API-et svarer `201` med den nye QR-koden, inkludert `id` og `shortLink`.

**4. Last ned bildet**

```bash theme={null}
curl "https://getqr.com/api/v1/qrs/{qrId}/download?format=png&resolution=1024" \
  -H "Authorization: Bearer $GETQR_API_KEY" \
  --output qr-code.png
```

## Forespørsler og svar

* **Format.** Send body i forespørselen som JSON med `Content-Type: application/json`. Unntaket er CSV-opplastingen for [masseopprettelse](https://docs.getqr.com/no/api/endpoints/bulk-qr-creations.md), som bruker `multipart/form-data`.
* **Svar.** Svarene er JSON. Nedlastinger, som QR-bilder og ZIP-arkiver fra masseopprettelse, returnerer selve filen.
* **Datoer.** Datoer er ISO 8601-strenger i UTC, for eksempel `2026-08-01T10:00:00.000Z`.
* **Spørringsparametere.** Boolske parametere tar strengene `true` eller `false`.
* **Delvise oppdateringer.** `PATCH`-endepunkter endrer bare feltene du sender.
* **Hemmeligheter.** Svar inneholder aldri passord eller interne ID-er. En passordbeskyttet QR-kode rapporterer bare `passwordProtected: true`.
* **Arbeidsområde.** Hver forespørsel kjøres i arbeidsområdet som API-nøkkelen din tilhører. Du sender ingen ID for arbeidsområdet. Se [Tilgang og roller](https://docs.getqr.com/no/api/authentication.md#tilgang-og-roller).
* **Feil.** Mislykkede forespørsler returnerer et `error`-objekt med en stabil `code`. Se [Feil](https://docs.getqr.com/no/api/errors.md).

## Paginering

Listeendepunkter (QR-koder, maler og planlagte rapporter) tar to spørringsparametere:

| Parameter | Beskrivelse |
| - | - |
| `page` | Siden som skal returneres. Standard er `1`. |
| `pageSize` | Resultater per side, maksimalt `100`. Standard er `100`. |

De svarer med en `data`-matrise og et `pagination`-objekt:

```json theme={null}
{
  "data": [ … ],
  "pagination": { "page": 1, "pageSize": 50, "total": 128, "hasMore": true }
}
```

| Felt | Beskrivelse |
| - | - |
| `page` | Siden du fikk. |
| `pageSize` | Sidestørrelsen du fikk. |
| `total` | Antall resultater på tvers av alle sider. |
| `hasMore` | `true` så lenge det finnes en side til. |

Be om neste side så lenge `hasMore` er `true`. En `pageSize` over `100` gir [`422`](https://docs.getqr.com/no/api/errors#valideringsfeil).

## Idempotens

En nettverksfeil kan gjøre deg usikker på om en forespørsel gikk gjennom. For å prøve [Opprett en QR-kode](https://docs.getqr.com/no/api/endpoints/qr-codes.md#opprett-en-qr-kode) på nytt på en trygg måte sender du en `Idempotency-Key`-header med en unik verdi du velger selv:

```bash theme={null}
-H "Idempotency-Key: order-4821-qr"
```

* Gjentar du forespørselen med samme nøkkel innen 24 timer, returneres det opprinnelige svaret i stedet for at det opprettes en ny QR-kode.
* Svarheaderen `x-idempotent-replay` er `true` for et gjentatt svar og `false` for et nytt.
* Hvis den første forespørselen med den nøkkelen fortsatt kjører, svarer API-et `409 conflict`. Prøv igjen når den er ferdig.
* Gjenbruker du en nøkkel med en annen body, svarer API-et `422 unprocessable_entity`.
* Uten headeren behandles en identisk body som sendes innen 30 sekunder, som et duplikat.

Masseopprettelser tar i stedet et `idempotencyKey`-felt i body. Se [Masseopprettelse av QR-koder](https://docs.getqr.com/no/api/endpoints/bulk-qr-creations.md).

## Hastighetsgrenser

Hver API-nøkkel kan sende opptil 600 forespørsler per minutt. Se [Hastighetsgrenser](https://docs.getqr.com/no/api/rate-limits.md).

## Kommer senere

Trykklare pakker er planlagt i en senere versjon.

## Neste steg

> [card] [Autentisering](https://docs.getqr.com/no/api/authentication.md)

> [card] [QR-koder](https://docs.getqr.com/no/api/endpoints/qr-codes.md)


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