Autentifikācija

qr3.app izmanto API atslēgas (Bearer-Token) autentifikācijai. Nav nekādu OAuth plūsmu — vienkārši ģenerējiet atslēgu un nekavējoties lietojiet to.

API atslēgas izveide

Piesakieties vietnē app.qr3.app
Dodieties uz Iestatījumi → API atslēgas
Noklikšķiniet uz Jauna atslēga
Izvēlieties vēlamās atļaujas (Scopes)
Nokopējiet atslēgu — tā tiks parādīta tikai vienu reizi!

Atslēgu veidi

Veids	Prefikss	Lietojums
Secret Key	`qr3_sk_`	Servera pusē (API, Backend)
Publishable Key	`qr3_pk_`	Klienta pusē (tikai lasīšanas piekļuve)
Test Key	`qr3_test_sk_`	Izstrādei (atsevišķi Rate-Limits)

Lietošana

HTTP galvene

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

Pieprasījumu limits tiek piemērots katrai API atslēgai pēc tās saglabātās vērtības. Jaunas atslēgas, kas izveidotas ar API, pašlaik izmanto 60 pieprasījumus minūtē neatkarīgi no plāna.

Pārsniegšanas gadījumā API atgriež 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	Apraksts
`*`	Pilna piekļuve
`codes:read`	QR kodu lasīšana
`codes:write`	QR kodu izveide un rediģēšana
`scans:read`	Skenēšanas statistikas lasīšana
`webhooks:write`	Webhooks konfigurēšana
`account:read`	Konta informācijas lasīšana