Uwierzytelnianie

qr3.app używa kluczy API (Bearer token) do uwierzytelniania. Nie ma przepływów OAuth — wystarczy wygenerować klucz i natychmiast go użyć.

Tworzenie klucza API

Zaloguj się na stronie app.qr3.app
Przejdź do Ustawienia → Klucze API
Kliknij Nowy klucz
Wybierz żądane uprawnienia (zakresy)
Skopiuj klucz — zostanie wyświetlony tylko raz!

Typy kluczy

Typ	Prefiks	Zastosowanie
Secret Key	`qr3_sk_`	Po stronie serwera (API, backend)
Publishable Key	`qr3_pk_`	Po stronie klienta (tylko do odczytu)
Test Key	`qr3_test_sk_`	Programowanie (własne limity żądań)

Użycie

Nagłówek 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

Limity żądań

Limit żądań jest egzekwowany dla każdego klucza API według jego zapisanej wartości. Nowe klucze utworzone przez API używają obecnie 60 żądań na minutę, niezależnie od planu.

W przypadku przekroczenia limitu API zwraca kod HTTP 429:

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

Zakresy

Zakres	Opis
`*`	Pełny dostęp
`codes:read`	Odczyt kodów QR
`codes:write`	Tworzenie i edycja kodów QR
`scans:read`	Odczyt statystyk skanowania
`webhooks:write`	Konfiguracja webhooków
`account:read`	Odczyt informacji o koncie