Autentifikacija

qr3.app koristi API ključeve (Bearer-Token) za autentifikaciju. Nema OAuth tokova — jednostavno generirajte ključ i odmah ga koristite.

Izrada API ključa

Prijavite se na app.qr3.app
Idite na Postavke → API ključevi
Kliknite na Novi ključ
Odaberite željene dozvole (scopes)
Kopirajte ključ — prikazuje se samo jednom!

Vrste ključeva

Vrsta	Prefiks	Upotreba
Secret Key	`qr3_sk_`	Na strani poslužitelja (API, backend)
Publishable Key	`qr3_pk_`	Na strani klijenta (samo za čitanje)
Test Key	`qr3_test_sk_`	Razvoj (vlastita ograničenja učestalosti)

Upotreba

HTTP zaglavlje

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

Ograničenja učestalosti

Plan	Zahtjevi/minuti	Zaglavlja odgovora
Free	30	`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`
Pro	120	←
Business	300	←
Agency	600	←

U slučaju prekoračenja, API vraća HTTP 429:

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

Opsezi (Scopes)

| Opseg (Scope) | Opis | |---|---|| | * | Puni pristup | | codes:read | Čitanje QR kodova | | codes:write | Izrada i uređivanje QR kodova | | scans:read | Čitanje statistike skeniranja | | webhooks:write | Konfiguracija webhookova | | account:read | Čitanje informacija o računu |