Ξεκινώντας
Ξεκινώντας
Είστε νέος στο qr3.app; Αυτή η επισκόπηση θα σας καθοδηγήσει στα βασικά σε περίπου 5 λεπτά — είτε θέλετε να δημιουργήσετε δυναμικούς σύντομους συνδέσμους (shortlinks), QR-Analytics είτε ένα EU Digital Product Passport.
Προτεινόμενη διαδρομή
- Εισαγωγή — Τι είναι το qr3.app, ποια προϊόντα είναι διαθέσιμα (Codes, DPPs, Resolver, Agent-Skills) και πώς είναι δομημένο το stack.
- Γρήγορη εκκίνηση — Βήματα με
curlαπό το πρώτο API-Key έως τον πρώτο έτοιμο κώδικα QR, συμπεριλαμβανομένης της δοκιμής ανακατεύθυνσης (redirect). - Ταυτοποίηση — Δημιουργία API-Keys, ορισμός Workspace-Headers, διαχείριση τοπικών secrets.
- SDKs, CLI & MCP — TypeScript-SDK, CLI (
npx @qr3/cli) και ο MCP-Server για AI-Agents.
Απευθείας στη δική σας περίπτωση χρήσης
Δημιουργία δυναμικού κώδικα QR POST /v1/codes, σύντομος έλεγχος ανακατεύθυνσης και το πρώτο Scan-Event στο Dashboard.
Δημιουργία Digital Product Passport Μπαταρία, κλωστοϋφαντουργικά προϊόντα και EU-Compliance-Validator μέσω του ίδιου API.
Εκτύπωση QR-Asset (SVG/PDF/EPS) Διανυσματικό PDF (RGB), SVG, PNG και EPS στο /v1/codes/:id/qr.*
Σύνδεση AI-Agent (MCP) create_dpp_qr και επιπλέον εργαλεία — απευθείας από Claude, Cursor ή Codex.
Τι θα χρειαστείτε πρόχειρο
- Έναν λογαριασμό στο app.qr3.app/sign-up (συμπεριλαμβάνεται δοκιμαστικό Workspace).
- Ένα API-Key (Dashboard → Ρυθμίσεις → API-Keys) στη μορφή
qr3_sk_…. - Για DPPs επιπλέον ένα GTIN και έναν αριθμό σειράς/παρτίδας. Όποιος δεν έχει (ακόμα) δικό του GTIN, μπορεί να χρησιμοποιήσει τη λειτουργία
BYO-GTIN(δείτε GS1-Onboarding).
Βοήθεια & Αναφορές
- Αναφορά API — όλα τα endpoints με παραδείγματα Request/Response.
- Διαδραστικό OpenAPI — δοκιμάστε το απευθείας στο πρόγραμμα περιήγησης (browser), η ταυτοποίηση αποθηκεύεται στο frontmatter.
- Αναφορά σφαλμάτων — RFC-7807 Problem-Types με οδηγίες επίλυσης.
- Changelog — Release-Notes του δημόσιου API.