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)

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

Rate Limits

Užklausų limitas taikomas kiekvienam API raktui pagal jo išsaugotą reikšmę. Nauji per API sukurti raktai šiuo metu naudoja 60 užklausų per minutę, nepriklausomai nuo plano.

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"
}

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ą