Ταυτοποίηση

Ταυτοποίηση

Το 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

Το όριο αιτημάτων εφαρμόζεται ανά κλειδί API σύμφωνα με την αποθηκευμένη τιμή του. Τα νέα κλειδιά που δημιουργούνται μέσω του API χρησιμοποιούν επί του παρόντος 60 αιτήματα ανά λεπτό, ανεξάρτητα από το πρόγραμμα.

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