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

# Introduktion til API'et

> Administrer QR-koder, skabeloner, statistik og rapporter fra din egen kode.

> [!NOTE]
>
> GetQR API'et er i beta og er tilgængeligt for udvalgte arbejdsområder. Detaljer kan ændre sig før den generelle udgivelse.

GetQR API'et er et REST API til det, du gør i dashboardet: opret og opdater QR-koder, download deres billeder, læs scanningsstatistik og eksportér rapporter. Du godkender med din kontos API-nøgle og kalder versionerede endepunkter under `/api/v1`.

## Hvad du kan gøre

> [card] [QR-koder](https://docs.getqr.com/da/api/endpoints/qr-codes.md)
>
> Opret, vis, opdater, sæt på pause, duplikér, slet og download QR-koder.

> [card] [Statistik](https://docs.getqr.com/da/api/endpoints/analytics.md)
>
> Samlede scanninger og opdelinger for én QR-kode eller hele arbejdsområdet.

> [card] [Rapporter](https://docs.getqr.com/da/api/endpoints/reports.md)
>
> Eksportér en enkeltstående rapport, eller planlæg tilbagevendende rapportmails.

> [card] [Skabeloner](https://docs.getqr.com/da/api/endpoints/templates.md)
>
> Gem designs, og anvend dem på nye QR-koder.

> [card] [Bulk-oprettelse af QR-koder](https://docs.getqr.com/da/api/endpoints/bulk-qr-creations.md)
>
> Opret op til 100 QR-koder på én gang fra JSON eller en CSV-fil.

> [card] [Filer](https://docs.getqr.com/da/api/endpoints/files.md)
>
> Upload PDF'er, billeder, videoer og logoer til dine QR-koder.

> [card] [Statustjek](https://docs.getqr.com/da/api/endpoints/health.md)
>
> Tjek, at API'et kører. Kræver ingen API-nøgle.

## Vejledninger

> [card] [QR-kodedata efter type](https://docs.getqr.com/da/api/guides/qr-types.md)
>
> Dataformatet for hver af de 16 QR-typer.

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

> [card] [Adgangsregler](https://docs.getqr.com/da/api/guides/access-rules.md)
>
> Tidsplaner, scanningsgrænser, adgangskoder, pause og sletning.

## Basis-URL

Alle endepunkter ligger under én basis-URL:

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

## Versionering

API-versionen er en del af stien: alle endepunkter ligger under `/api/v1/`.

* Ændringer, der bryder kompatibiliteten, udgives under et nyt versionspræfiks som `/api/v2/`, og `/api/v1/` fortsætter med at virke.
* Tilføjelser, f.eks. nye valgfrie felter eller nye endepunkter, kan komme inden for v1. Ignorer felter i svaret, som din kode ikke kender.

## Kom hurtigt i gang

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

Generér eller vis din nøgle i dine kontoindstillinger. Se [Godkendelse](https://docs.getqr.com/da/api/authentication.md).

**2. Tjek, at API'et kan nås**

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

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

**3. Opret 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-kode, inklusive dens `id` og `shortLink`.

**4. Download billedet**

```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ørgsler og svar

* **Format.** Send forespørgslens body som JSON med `Content-Type: application/json`. Undtagelsen er CSV-uploaden til [bulk-oprettelse](https://docs.getqr.com/da/api/endpoints/bulk-qr-creations.md), som bruger `multipart/form-data`.
* **Svar.** Svar er JSON. Downloads, f.eks. QR-billeder og ZIP-arkiver fra bulk-oprettelse, returnerer selve filen.
* **Datoer.** Datoer er ISO 8601-strenge i UTC, f.eks. `2026-08-01T10:00:00.000Z`.
* **Forespørgselsparametre.** Booleske parametre tager strengene `true` eller `false`.
* **Delvise opdateringer.** `PATCH`-endepunkter ændrer kun de felter, du sender.
* **Hemmeligheder.** Svar indeholder aldrig adgangskoder eller interne id'er. En adgangskodebeskyttet QR-kode viser kun `passwordProtected: true`.
* **Arbejdsområde.** Hver forespørgsel kører i det arbejdsområde, din API-nøgle hører til. Du angiver ikke et arbejdsområde-id. Se [Adgang og roller](https://docs.getqr.com/da/api/authentication.md#adgang-og-roller).
* **Fejl.** Mislykkede forespørgsler returnerer et `error`-objekt med en stabil `code`. Se [Fejl](https://docs.getqr.com/da/api/errors.md).

## Paginering

Listeendepunkter (QR-koder, skabeloner og planlagte rapporter) tager to forespørgselsparametre:

| Parameter | Beskrivelse |
| - | - |
| `page` | Siden, der returneres. Standard er `1`. |
| `pageSize` | Resultater pr. side, højst `100`. Standard er `100`. |

De svarer med et `data`-array og et `pagination`-objekt:

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

| Felt | Beskrivelse |
| - | - |
| `page` | Den side, du fik. |
| `pageSize` | Den sidestørrelse, du fik. |
| `total` | Antal resultater på tværs af alle sider. |
| `hasMore` | `true`, så længe der venter en side mere. |

Hent næste side, så længe `hasMore` er `true`. En `pageSize` over `100` returnerer [`422`](https://docs.getqr.com/da/api/errors#valideringsfejl).

## Idempotens

En netværksfejl kan gøre dig i tvivl om, hvorvidt en forespørgsel gik igennem. For at prøve [Opret en QR-kode](https://docs.getqr.com/da/api/endpoints/qr-codes.md#opret-en-qr-kode) igen uden risiko skal du sende en `Idempotency-Key`-header med en unik værdi, du selv vælger:

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

* Gentager du forespørgslen med samme nøgle inden for 24 timer, returneres det oprindelige svar i stedet for at oprette en QR-kode mere.
* Svarheaderen `x-idempotent-replay` er `true` for et gentaget svar og `false` for et nyt.
* Hvis den første forespørgsel med nøglen stadig kører, svarer API'et `409 conflict`. Prøv igen, når den er færdig.
* Genbruger du en nøgle med en anden body, svarer API'et `422 unprocessable_entity`.
* Uden headeren behandles en identisk body, der sendes inden for 30 sekunder, som en dublet.

Bulk-oprettelser tager i stedet et `idempotencyKey`-felt i forespørgslens body. Se [Bulk-oprettelse af QR-koder](https://docs.getqr.com/da/api/endpoints/bulk-qr-creations.md).

## Hastighedsgrænser

Hver API-nøgle kan sende op til 600 forespørgsler pr. minut. Se [Hastighedsgrænser](https://docs.getqr.com/da/api/rate-limits.md).

## Kommer senere

Trykklare pakker er planlagt til en senere version.

## Næste skridt

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

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


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