Authenticatie

qr3.app gebruikt API-sleutels (Bearer-tokens) voor authenticatie. Er zijn geen OAuth-flows — genereer gewoon een sleutel en gebruik deze direct.

API-sleutel maken

Meld je aan op app.qr3.app
Ga naar Instellingen → API-sleutels
Klik op Nieuwe sleutel
Kies de gewenste machtigingen (scopes)
Kopieer de sleutel — deze wordt slechts eenmalig weergegeven!

Sleuteltypes

Type	Prefix	Gebruik
Secret Key	`qr3_sk_`	Server-side (API, backend)
Publishable Key	`qr3_pk_`	Client-side (alleen-lezen)
Test Key	`qr3_test_sk_`	Ontwikkeling (eigen rate limits)

Publishable Keys (qr3_pk_) ontvangen geen persoonsgegevens. Routes die namen, e-mailadressen of gebruikers-ID’s van personen teruggeven, antwoorden op zo’n sleutel met 403: GET /v1/members, GET /v1/workspace/stats/code-creators, GET /v1/audit-logs, GET /v1/organizations, GET /v1/organizations/:id, GET /v1/codes/:id/comments.

Gebruik

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
# or:
export QR3_API_KEY=qr3_sk_your_key_here

Rate limits

Elke API-sleutel mag 60 verzoeken per minuut verzenden, op elk abonnement. De limiet is van toepassing per sleutel, niet per werkruimte of organisatie.

Bij overschrijding retourneert de API HTTP 429:

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

Scopes

Scope	Beschrijving
`*`	Volledige toegang
`codes:read`	QR-codes lezen
`codes:write`	QR-codes maken en bewerken
`scans:read`	Scanstatistieken lezen
`webhooks:write`	Webhooks configureren
`account:read`	Accountgegevens lezen