Awtentikazzjoni

Awtentikazzjoni

qr3.app juża API-Keys (Bearer-Token) għall-awtentikazzjoni. M’hemm l-ebda OAuth-flows — sempliċement iġġenera l-Key u użaha immedjatament.

Kif toħloq API-Key

1. Idħol f’ app.qr3.app
2. Mur fuq Settings → API-Keys
3. Ikklikkja fuq Key Ġdida
4. Agħżel il-permessi mixtieqa (Scopes)
5. Ikkopja l-Key — se tintwera darba biss!

Tipi ta’ Keys

Tip	Prefiss	Użu
Secret Key	qr3_sk_	Naħa tas-server (API, Backend)
Publishable Key	qr3_pk_	Naħa tal-klijent (aċċess għall-qari biss)
Test Key	qr3_test_sk_	Żvilupp (rate-limits tagħhom stess)

Caution

Secret Keys (qr3_sk_) m’għandhom qatt jintużaw fil-frontend jew f’kodiċi fuq in-naħa tal-klijent.

Użu

Headers tal-HTTP

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 Limits

Pjan	Requests/Minuta	Response-Headers
Free	30	X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Pro	120	←
Business	300	←
Agency	600	←

F’każ li jinqabeż il-limitu, l-API tirritorna HTTP 429:

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

Scopes

Scope	Deskrizzjoni
*	Aċċess sħiħ
codes:read	Aqra l-QR-Codes
codes:write	Oħloq u editja l-QR-Codes
scans:read	Aqra l-istatistika tal-iskans
webhooks:write	Ikkonfigura l-webhooks
account:read	Aqra l-informazzjoni tal-kont