Autentificare

Autentificare

qr3.app utilizează chei API (Bearer-Token) pentru autentificare. Nu există fluxuri OAuth — pur și simplu generezi cheia și o folosești imediat.

Crearea unei chei API

1. Autentifică-te pe app.qr3.app
2. Mergi la Setări → Chei API
3. Fă clic pe Cheie nouă
4. Selectează permisiunile dorite (Scopes)
5. Copiază cheia — va fi afișată o singură dată!

Tipuri de chei

Tip	Prefix	Utilizare
Secret Key	qr3_sk_	Pe partea de server (API, Backend)
Publishable Key	qr3_pk_	Pe partea de client (doar acces de citire)
Test Key	qr3_test_sk_	Dezvoltare (rate-limit-uri proprii)

Atenție

Cheile Secret (qr3_sk_) nu trebuie folosite niciodată în frontend sau în codul de pe partea de client.

Utilizare

Header 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

Limita de cereri este aplicată pentru fiecare cheie API conform valorii sale stocate. Cheile noi create prin API folosesc în prezent 60 de cereri pe minut, independent de plan.

În caz de depășire, API-ul returnează HTTP 429:

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

Scopes

Scope	Descriere
*	Acces complet
codes:read	Citire coduri QR
codes:write	Creare și editare coduri QR
scans:read	Citire statistici scanări
webhooks:write	Configurare webhook-uri
account:read	Citire informații cont