Έκδοση API & Πολιτική LTS

Έκδοση API & Πολιτική LTS

Σχήμα Έκδοσης

Το qr3.app χρησιμοποιεί έκδοση βάσει URL: /v1/, /v2/, κ.λπ.

https://qr3.app/v1/codes
                    ^^^
                    Versionspräfix

Η τρέχουσα σταθερή έκδοση είναι η v1 LTS .

---

Κύκλος Ζωής Εκδόσεων

Neu         → Stable (LTS) → Maintenance → End-of-Life
 Beta-Phase    Aktiv            Nur Fixes      Eingestellt
 (0–3 Monate)  (12+ Monate)     (6 Monate)     (danach)

Έκδοση	Κατάσταση	Υποστήριξη έως	Σημειώσεις
v1	✅ Stable (LTS)	Τουλάχιστον Μάρτιος 2027	Τρέχουσα έκδοση παραγωγής
v2	📋 Προγραμματισμένη	—	Roadmap: Φάση 5+

---

Breaking Changes — Ορισμός

Μια Breaking Change είναι οποιαδήποτε αλλαγή που διακόπτει τη λειτουργία των υπαρχόντων clients χωρίς προσαρμογή:

• Κατάργηση ή μετονομασία πεδίων Request/Response
• Αλλαγή των HTTP status codes για υπάρχοντα σενάρια
• Κατάργηση Endpoints
• Αλλαγή της μεθόδου ταυτοποίησης (authentication)
• Ασύμβατες αλλαγές στη μορφή σφαλμάτων

Δεν αποτελούν Breaking Changes (συμβατές επεκτάσεις):

• Προσθήκη προαιρετικών πεδίων Request
• Προσθήκη νέων πεδίων Response
• Νέα Endpoints
• Νέες προαιρετικές παράμετροι Query
• Νέοι κωδικοί σφάλματος (το RFC 7807 παραμένει συμβατό)

---

Επικοινωνία των Breaking Changes

Οι Breaking Changes δεν πραγματοποιούνται ποτέ χωρίς προειδοποίηση:

1. Ανακοίνωση: Τουλάχιστον 90 ημέρες πριν από τη Breaking Change
2. Κανάλι: E-mail σε όλους τους χρήστες του API + Banner στο Dashboard + CHANGELOG.md
3. Βοήθεια μετανάστευσης: Οδηγός μετανάστευσης και παραδείγματα κώδικα
4. Deprecation Headers: Το API παρέχει HTTP headers Deprecation + Sunset

HTTP/1.1 200 OK
Deprecation: true
Sunset: Sat, 01 Mar 2027 00:00:00 GMT
Link: <https://docs.qr3.app/de/api/versioning>; rel="deprecation"

---

Εγγυήσεις LTS (v1)

Για την τρέχουσα έκδοση LTS v1 ισχύουν τα εξής:

Εγγύηση	Χρονική περίοδος
Καμία Breaking Change	Τουλάχιστον 12 μήνες από την κατάσταση Stable
Security Patches	Για όλη τη διάρκεια ζωής της LTS
Bug Fixes	Για όλη τη διάρκεια ζωής της LTS
Maintenance Mode	6 μήνες μετά το τέλος της LTS
Πλήρης υποστήριξη	Τουλάχιστον έως τον Μάρτιο 2027

Versionierung im SDK

Το TypeScript SDK (@qr3/sdk) και το CLI (@qr3/cli) ακολουθούν επίσης το SemVer. Οι Breaking Changes στο SDK αντικατοπτρίζουν πάντα τις Breaking Changes στο API.

---

Αναγνώριση Έκδοσης

Κάθε API response περιέχει μεταδεδομένα για την τρέχουσα έκδοση:

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "api_version": "1.0.0"
  }
}

Το endpoint GET /v1/health παρέχει επιπλέον:

{
  "version": "1.0.0",
  "environment": "production",
  "status": "ok"
}

---

Μετανάστευση μεταξύ Εκδόσεων

Όταν κυκλοφορεί μια νέα κύρια έκδοση, η παλιά έκδοση παραμένει ενεργή παράλληλα για τουλάχιστον 6 μήνες.

Παρέχουμε:

• Πλήρες diff όλων των τροποποιημένων endpoints
• Αυτοματοποιημένο εργαλείο μετανάστευσης (όπου είναι εφικτό)
• Προσωπική υποστήριξη μετανάστευσης για πελάτες Business/Agency

---

Πολιτική Deprecation για μεμονωμένα Endpoints

Μεμονωμένα endpoints μπορούν επίσης να επισημανθούν ως deprecated εντός μιας έκδοσης:

GET /v1/codes HTTP/1.1

HTTP/1.1 200 OK
Deprecation: true
Sunset: Thu, 01 Jan 2026 00:00:00 GMT
Link: <https://docs.qr3.app/de/api/codes>; rel="deprecation"

Caution

Μην αγνοείτε τα Deprecation headers. Τα endpoints καταργούνται μετά την ημερομηνία Sunset, ακόμη και αν δεν αποτελούσαν ακόμη Breaking Change.

---

Changelog

Όλες οι αλλαγές στο API τεκμηριώνονται στο αρχείο CHANGELOG.md στο αποθετήριο.

Ημερομηνία	Έκδοση	Τύπος	Περιγραφή
Μάρτιος 2026	v1.0.0	Αρχική	Πρώτη σταθερή κυκλοφορία: QR-Codes, Redirect, Auth, Billing
Μάρτιος 2026	v1.1.0	Feature	Batch-API, A/B-Destinations, Expiry, PDF-Export
Μάρτιος 2026	v1.2.0	Feature	Organizations, Workspaces, Audit-Logs, Comments, GDPR-Endpoints

---

Ερωτήσεις;

Για ερωτήσεις σχετικά με την πολιτική εκδόσεων: [email protected]