Autentificering

Autentificering

qr3.app bruger API-nøgler (Bearer-token) til autentificering. Der er ingen OAuth-flows — generer blot en nøgle og brug den med det samme.

Opret API-nøgle

1. Log ind på app.qr3.app
2. Gå til Indstillinger → API-nøgler
3. Klik på Ny nøgle
4. Vælg de ønskede tilladelser (Scopes)
5. Kopier nøglen — den vises kun én gang!

Nøgletyper

Type	Præfiks	Anvendelse
Secret Key	qr3_sk_	Serverside (API, backend)
Publishable Key	qr3_pk_	Clientside (kun læseadgang)
Test Key	qr3_test_sk_	Udvikling (egne rate-limits)

Caution

Secret Keys (qr3_sk_) må aldrig bruges i frontend eller i kode på clientside.

Anvendelse

HTTP-header

Authorization: Bearer qr3_sk_your_key_here

cURL

curl https://qr3.app/v1/codes \
  -H "Authorization: Bearer qr3_sk_your_key_here"

TypeScript SDK

import { QR3 } from "@qr3/sdk";

const client = new QR3({ apiKey: "qr3_sk_your_key_here" });
const codes = await client.codes.list();

CLI

qr3 login
# oder:
export QR3_API_KEY=qr3_sk_your_key_here

Rate Limits

Anmodningsgrænsen håndhæves pr. API-nøgle ud fra dens gemte værdi. Nye nøgler oprettet via API’et bruger i øjeblikket 60 anmodninger pr. minut uafhængigt af abonnement.

Hvis grænsen overskrides, returnerer API’en HTTP 429:

{
  "type": "https://docs.qr3.app/errors/rate-limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit of 60 requests/minute exceeded"
}

Scopes

Scope	Beskrivelse
*	Fuld adgang
codes:read	Læs QR-koder
codes:write	Opret og rediger QR-koder
scans:read	Læs scanningsstatistikker
webhooks:write	Konfigurer webhooks
account:read	Læs kontooplysninger