Gå til indhold

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

TypePræfiksAnvendelse
Secret Keyqr3_sk_Serverside (API, backend)
Publishable Keyqr3_pk_Clientside (kun læseadgang)
Test Keyqr3_test_sk_Udvikling (egne rate-limits)

Anvendelse

HTTP-header

Authorization: Bearer qr3_sk_your_key_here

cURL

Terminal window
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

Terminal window
qr3 login
# oder:
export QR3_API_KEY=qr3_sk_your_key_here

Rate Limits

AbonnementAnmodninger/minutResponse-headere
Free30X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Pro120
Business300
Agency600

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 30 requests/minute exceeded"
}

Scopes

ScopeBeskrivelse
*Fuld adgang
codes:readLæs QR-koder
codes:writeOpret og rediger QR-koder
scans:readLæs scanningsstatistikker
webhooks:writeKonfigurer webhooks
account:readLæs kontooplysninger