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

Plan	Cereri/Minut	Header-e de răspuns
Free	30	X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Pro	120	←
Business	300	←
Agency	600	←

Î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 30 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