Avtentikacija

qr3.app uporablja API-ključe (Bearer žetone) za avtentikacijo. Ni tokov OAuth — preprosto ustvarite ključ in ga takoj uporabite.

Ustvarjanje API-ključa

Prijavite se na app.qr3.app
Pojdite na Nastavitve → API-ključi
Kliknite na Nov ključ
Izberite želena dovoljenja (Scopes)
Kopirajte ključ — prikazan bo samo enkrat!

Vrste ključev

Vrsta	Predpona	Uporaba
Secret Key	`qr3_sk_`	Na strežniški strani (API, zaledje)
Publishable Key	`qr3_pk_`	Na odjemalski strani (samo za branje)
Test Key	`qr3_test_sk_`	Razvoj (lastne omejitve porabe)

Ključi Publishable Key (qr3_pk_) ne prejmejo osebnih podatkov. Poti, ki vračajo imena, e-poštne naslove ali uporabniške ID-je oseb, nanje odgovorijo s 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.

Uporaba

HTTP-glava

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

Vsak ključ API lahko pošlje 60 zahtev na minuto v vseh paketih. Omejitev velja za posamezen ključ, ne za delovni prostor ali organizacijo.

V primeru prekoračitve API vrne 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 | Opis | |---|---|| | * | Poln dostop | | codes:read | Branje QR-kod | | codes:write | Ustvarjanje in urejanje QR-kod | | scans:read | Branje statistike skeniranja | | webhooks:write | Konfiguracija spletnih kavljev (webhooks) | | account:read | Branje podatkov o računu |