Hitelesítés

A qr3.app API-kulcsokat (Bearer-token) használ a hitelesítéshez. Nincsenek OAuth-folyamatok — egyszerűen generálj egy kulcsot, és használd azonnal.

API-kulcs létrehozása

Jelentkezz be az app.qr3.app oldalon
Menj a Beállítások → API-kulcsok menüpontba
Kattints az Új kulcs gombra
Válaszd ki a kívánt jogosultságokat (Scope-okat)
Másold ki a kulcsot — csak egyszer kerül megjelenítésre!

Kulcstípusok

Típus	Előtag	Használat
Secret Key	`qr3_sk_`	Szerveroldali (API, backend)
Publishable Key	`qr3_pk_`	Kliensoldali (csak olvasható)
Test Key	`qr3_test_sk_`	Fejlesztés (saját Rate-Limitek)

Használat

HTTP-fejléc

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 Limitek

Csomag	Kérések/perc	Válaszfejlécek
Free	30	`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`
Pro	120	←
Business	300	←
Agency	600	←

Túllépés esetén az API HTTP 429 választ ad vissza:

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

Scope-ok

Scope	Leírás
`*`	Teljes hozzáférés
`codes:read`	QR-kódok olvasása
`codes:write`	QR-kódok létrehozása és szerkesztése
`scans:read`	Beolvasási statisztikák olvasása
`webhooks:write`	Webhookok konfigurálása
`account:read`	Fiókinformációk olvasása