Αναφορά API

Το REST API του qr3.app είναι προσβάσιμο στη διεύθυνση https://qr3.app/v1/ και ακολουθεί πιστά τις συμβάσεις από την Επισκόπηση API (ταυτοποίηση μέσω Authorization: Bearer, σφάλματα κατά το RFC 7807, σελιδοποίηση με cursor).

Ξεκινώντας

Επισκόπηση API Έκδοση, μορφή Request/Response, ιδιοδυναμία, σελιδοποίηση.

Ταυτοποίηση API Keys, Workspace Headers, δοκιμαστικό vs. ζωντανό περιβάλλον.

Αναφορά Σφαλμάτων Τύποι σφαλμάτων RFC 7807 με κωδικούς κατάστασης και παραδείγματα.

Διαδραστική Αναφορά OpenAPI 3.1 + Scalar-Playground — εισαγάγετε tokens και δοκιμάστε απευθείας.

Περιοχές Πόρων

QR Codes Δημιουργία, ενημέρωση, παρακολούθηση και ασφαλής ανακατεύθυνση δυναμικών & στατικών κωδικών.

Οργανισμοί & Workspaces Λογαριασμοί, Workspaces, συνδρομές μέλους και όρια πακέτων.

Webhooks Εγγραφή σε συμβάντα, επαλήθευση υπογραφής, αρχεία καταγραφής παράδοσης.

MCP & Agents Model Context Protocol — δημιουργία QR Codes και DPPs από AI Agents.

Προστασία Δεδομένων & Endpoints Ιδιωτικότητας Εξαγωγή GDPR, διαγραφή λογαριασμών, IP hashing, συναινέσεις.

Έκδοση & Κατάργηση (Deprecation) Πώς εισάγονται νέα πεδία και τι προκαλεί breaking changes.

Endpoints ειδικά για DPP

Όλα τα endpoints του Ψηφιακού Διαβατηρίου Προϊόντος (Digital Product Passport) τεκμηριώνονται στη δική τους ενότητα Digital Product Passport — συμπεριλαμβανομένων των αναφορών σχημάτων για μπαταρίες και κλωστοϋφαντουργικά προϊόντα, του εργαλείου επικύρωσης συμμόρφωσης της ΕΕ και του δημόσιου GS1 Resolver.

Βασικά URL ανά Περιβάλλον

Περιβάλλον	Βασικό URL	Σκοπός
Production	`https://qr3.app/v1/`	Δημόσιο Live API
Stage	`https://qr3-api-stage.<account>.workers.dev/v1/`	Pre-Production Pilot (βλ. `ENVIRONMENTS.md`)
Τοπικό	`http://localhost:8787/v1/`	`pnpm --filter api dev`

Οι προδιαγραφές OpenAPI βρίσκονται στη διεύθυνση https://qr3.app/v1/openapi.json και ενημερώνονται αυτόματα με κάθε deploy.