Ταυτοποίηση

Ταυτοποίηση

Το qr3.app χρησιμοποιεί API-Keys (Bearer-Token) για ταυτοποίηση. Δεν υπάρχουν ροές OAuth — απλώς δημιουργήστε ένα κλειδί και χρησιμοποιήστε το αμέσως.

Δημιουργία API-Key

1. Συνδεθείτε στο app.qr3.app
2. Μεταβείτε στο Ρυθμίσεις → API-Keys
3. Κάντε κλικ στο Νέο κλειδί
4. Επιλέξτε τα επιθυμητά δικαιώματα (Scopes)
5. Αντιγράψτε το κλειδί — εμφανίζεται μόνο μία φορά!

Τύποι κλειδιών

Τύπος	Πρόθεμα	Χρήση
Secret Key	qr3_sk_	Από την πλευρά του διακομιστή (API, Backend)
Publishable Key	qr3_pk_	Από την πλευρά του πελάτη (μόνο ανάγνωση)
Test Key	qr3_test_sk_	Ανάπτυξη (ξεχωριστά Rate-Limits)

Caution

Τα Secret Keys (qr3_sk_) δεν πρέπει ποτέ να χρησιμοποιούνται στο Frontend ή σε κώδικα από την πλευρά του πελάτη.

Χρήση

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

Πρόγραμμα	Requests/Λεπτό	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 | | codes:write | Δημιουργία και επεξεργασία QR-Codes | | scans:read | Ανάγνωση στατιστικών σάρωσης | | webhooks:write | Διαμόρφωση Webhooks | | account:read | Ανάγνωση πληροφοριών λογαριασμού |