Autentizace

qr3.app používá k autentizaci API klíče (Bearer tokeny). Neexistují žádné OAuth toky — stačí vygenerovat klíč a okamžitě jej použít.

Vytvoření API klíče

Přihlaste se na app.qr3.app
Přejděte do Nastavení → API klíče
Klikněte na Nový klíč
Vyberte požadovaná oprávnění (Scopes)
Zkopírujte klíč — zobrazí se pouze jednou!

Typy klíčů

Typ	Prefix	Použití
Secret Key	`qr3_sk_`	Na straně serveru (API, backend)
Publishable Key	`qr3_pk_`	Na straně klienta (pouze pro čtení)
Test Key	`qr3_test_sk_`	Vývoj (vlastní rate limity)

Použití

HTTP hlavička

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 limity

Limit požadavků se uplatňuje pro každý API klíč podle jeho uložené hodnoty. Nové klíče vytvořené přes API v současnosti používají 60 požadavků za minutu nezávisle na tarifu.

Při překročení vrátí 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"
}

Scopes

Scope	Popis
`*`	Plný přístup
`codes:read`	Čtení QR kódů
`codes:write`	Vytváření a úprava QR kódů
`scans:read`	Čtení statistik skenování
`webhooks:write`	Konfigurace webhooků
`account:read`	Čtení informací o účtu