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)

Iċ-ċwievet Publishable Key (qr3_pk_) ma jirċievu l-ebda data personali. Ir-rotot li jagħtu ismijiet, indirizzi tal-email jew IDs tal-utenti ta’ persuni jwieġbuhom b’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.

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

Rate Limits

Kull API key tista’ tibgħat 60 talba kull minuta, fuq kull pjan. Il-limitu japplika għal kull key, mhux għal kull workspace jew organizzazzjoni.

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 60 requests/minute exceeded for this API key"
}

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