Autentifikácia

qr3.app používa API kľúče (Bearer tokeny) na autentifikáciu. Neexistujú žiadne OAuth toky — stačí vygenerovať kľúč a okamžite ho použiť.

Vytvorenie API kľúča

Prihláste sa na app.qr3.app
Prejdite do Nastavenia → API kľúče
Kliknite na Nový kľúč
Vyberte požadované oprávnenia (Scopes)
Skopírujte si kľúč — zobrazí sa iba raz!

Typy kľúčov

Typ	Prefix	Použitie
Secret Key	`qr3_sk_`	Na strane servera (API, backend)
Publishable Key	`qr3_pk_`	Na strane klienta (iba na čítanie)
Test Key	`qr3_test_sk_`	Vývoj (vlastné rate limity)

Kľúče Publishable Key (qr3_pk_) nedostávajú žiadne osobné údaje. Cesty, ktoré vracajú mená, e-mailové adresy alebo ID používateľov, na ne odpovedajú kódom 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.

Použitie

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

Rate Limits

Každý API kľúč môže odoslať 60 požiadaviek za minútu, v každom pláne. Limit sa uplatňuje na kľúč, nie na pracovný priestor alebo organizáciu.

Pri prekročení vráti 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 | Popis | |---|---|| | * | Úplný prístup | | codes:read | Čítanie QR kódov | | codes:write | Vytváranie a úprava QR kódov | | scans:read | Čítanie štatistík skenovania | | webhooks:write | Konfigurácia webhookov | | account:read | Čítanie informácií o účte |