Автентикация

qr3.app използва API-Keys (Bearer-Token) за автентикация. Няма OAuth-Flows — просто генерирайте Key и го използвайте веднага.

Създаване на API-Key

Влезте в профила си на app.qr3.app
Отидете на Настройки → API-Keys
Кликнете върху Нов Key
Изберете желаните разрешения (Scopes)
Копирайте Key — той се показва само веднъж!

Типове Key

Тип	Префикс	Употреба
Secret Key	`qr3_sk_`	От страна на сървъра (API, Backend)
Publishable Key	`qr3_pk_`	От страна на клиента (само за четене)
Test Key	`qr3_test_sk_`	Разработка (собствени Rate-Limits)

Употреба

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

Rate Limits

План	Заявки/минута	Response-Headers
Free	30	`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`
Pro	120	←
Business	300	←
Agency	600	←

При превишаване API връща HTTP 429:

{
  "type": "https://docs.qr3.app/errors/rate-limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit of 30 requests/minute exceeded"
}

Scopes

Scope	Описание
`*`	Пълен достъп
`codes:read`	Четене на QR-кодове
`codes:write`	Създаване и редактиране на QR-кодове
`scans:read`	Четене на статистики за сканиранията
`webhooks:write`	Конфигуриране на Webhooks
`account:read`	Четене на информация за акаунта