Autentifikavimas

qr3.app autentifikavimui naudoja API raktus (Bearer-Token). Nėra jokių OAuth srautų — tiesiog sugeneruokite raktą ir iškart naudokite.

API rakto kūrimas

Prisijunkite adresu app.qr3.app
Eikite į Nustatymai → API raktai
Spustelėkite Naujas raktas
Pasirinkite norimus leidimus (Scopes)
Nukopijuokite raktą — jis rodomas tik vieną kartą!

Raktų tipai

Tipas	Prefiksas	Naudojimas
Secret Key	`qr3_sk_`	Serverio pusėje (API, Backend)
Publishable Key	`qr3_pk_`	Kliento pusėje (tik skaitymo prieiga)
Test Key	`qr3_test_sk_`	Kūrimui (atskiri Rate-Limits)

Publishable Key raktai (qr3_pk_) negauna asmens duomenų. Maršrutai, grąžinantys asmenų vardus, el. pašto adresus ar naudotojų ID, į juos atsako 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.

Naudojimas

HTTP-Header

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

Kiekvienas API raktas gali išsiųsti 60 užklausų per minutę, nepriklausomai nuo plano. Šis limitas taikomas kiekvienam raktui atskirai, o ne darbo sričiai (workspace) ar organizacijai.

Viršijus ribą, API grąžina 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	Aprašymas
`*`	Pilna prieiga
`codes:read`	Skaityti QR kodus
`codes:write`	Kurti ir redaguoti QR kodus
`scans:read`	Skaityti nuskaitymų statistiką
`webhooks:write`	Konfigūruoti Webhooks
`account:read`	Skaityti paskyros informaciją