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)

Publishable Key atslēgas (qr3_pk_) nesaņem personas datus. Maršruti, kas atgriež personu vārdus, e-pasta adreses vai lietotāju ID, uz tām atbild ar 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.

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

Rate Limits

Katra API atslēga drīkst nosūtīt 60 pieprasījumus minūtē jebkurā plānā. Limits tiek piemērots katrai atslēgai, nevis darba videi vai organizācijai.

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

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