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

Autentifică-te pe app.qr3.app
Mergi la Setări → Chei API
Fă clic pe Cheie nouă
Selectează permisiunile dorite (Scopes)
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)

Cheile Publishable Key (qr3_pk_) nu primesc date personale. Rutele care returnează nume, adrese de e-mail sau ID-uri de utilizator ale persoanelor le răspund cu 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.

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

Rate Limits

Fiecare cheie API poate trimite 60 de cereri pe minut, în cadrul oricărui plan. Limita se aplică pentru fiecare cheie în parte, nu per spațiu de lucru sau organizație.

Î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 for this API key"
}

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