Λογότυπο στον κώδικα QR

Ένας κώδικας μπορεί να φέρει ένα προαιρετικό λογότυπο στο κέντρο του – το δικό σας brand αντί για ένα απλό μοτίβο QR. Το λογότυπο ενσωματώνεται ως πραγματικά pixel στα ληφθέντα αρχεία SVG και PNG· τα αρχεία PDF και EPS δεν το περιέχουν ποτέ.

Note

Ένα λογότυπο αυξάνει τη διόρθωση σφαλμάτων του κώδικα στο επίπεδο H, ώστε το μοτίβο να παραμένει σκανάσιμο ακόμα και με μερικώς καλυμμένη εικόνα. Τι σημαίνει αυτό για ήδη εκτυπωμένους κώδικες περιγράφεται παρακάτω στην ενότητα Εκτύπωση.

Στο Dashboard

Ανοίξτε τη σελίδα λεπτομερειών ενός κώδικα. Δίπλα στην προεπισκόπηση QR και τα κουμπιά λήψης βρίσκεται η κάρτα Λογότυπο στον κώδικα QR.

1. Κάντε κλικ στο Επιλογή λογοτύπου και επιλέξτε ένα αρχείο PNG, JPEG ή WebP (το πολύ 1 MB – μεγαλύτερα ή άλλα φορμάτ, συμπεριλαμβανομένου του SVG, απορρίπτονται ήδη πριν από τη μεταφόρτωση).
2. Εμφανίζεται μια προεπισκόπηση του επιλεγμένου αρχείου μαζί με μια ειδοποίηση:
   • Δεν υπάρχει ακόμα λογότυπο – η προσθήκη αλλάζει το μοτίβο κουκκίδων του κώδικα. Επιβεβαιώστε επιλέγοντας το πλαίσιο ελέγχου και, στη συνέχεια, κάντε κλικ στο Μεταφόρτωση λογοτύπου.
   • Έχει ήδη οριστεί λογότυπο – η αντικατάσταση αλλάζει μόνο την εικόνα στο κέντρο, το μοτίβο παραμένει το ίδιο. Κάντε κλικ στο Αντικατάσταση λογοτύπου· δεν απαιτείται επιβεβαίωση.
3. Για κατάργηση, κάντε κλικ στο Κατάργηση λογοτύπου, επιβεβαιώστε το πλαίσιο προειδοποίησης (και η κατάργηση αλλάζει το μοτίβο) και επιβεβαιώστε την κατάργηση για δεύτερη φορά.

Caution

Μόνο ένας ρόλος εγγραφής μπορεί να μεταφορτώσει, να αντικαταστήσει ή να καταργήσει ένα λογότυπο. Ο ρόλος viewer βλέπει την τρέχουσα κατάσταση και, μόλις οριστεί ένα λογότυπο, την ειδοποίηση για τα φορμάτ εκτύπωσης – αλλά καμία από τις τρεις ενέργειες.

Μέσω API

Μεταφόρτωση ή αντικατάσταση λογοτύπου

POST /v1/codes/{id}/logo – Multipart αίτημα, πεδίο file.

cURL

curl -X POST https://qr3.app/v1/codes/qr_a1b2c3d4/logo \
  -H "Authorization: Bearer qr3_sk_..." \
  -F "[email protected]"

Απάντηση (HTTP 201): ο ενημερωμένος κώδικας, με ορισμένο το logo_file_id.

Το αρχείο ελέγχεται με βάση τα Magic Bytes του, όχι με βάση την επέκταση ή το Content-Type. Κανονικοποιείται σε ένα διαφανές PNG με διαστάσεις 512 × 512 px (διατηρώντας την αναλογία διαστάσεων). Ένα υπάρχον λογότυπο αντικαθίσταται – υπάρχει πάντα μόνο ένα λογότυπο ανά κώδικα.

Κατάργηση λογοτύπου

DELETE /v1/codes/{id}/logo – χωρίς σώμα (body).

curl -X DELETE https://qr3.app/v1/codes/qr_a1b2c3d4/logo \
  -H "Authorization: Bearer qr3_sk_..."

Απάντηση (HTTP 200): ο ενημερωμένος κώδικας, με το logo_file_id να έχει οριστεί ξανά σε null. Ισοδύναμο (idempotent) – μια κλήση χωρίς να υπάρχει ήδη λογότυπο επιστρέφει επίσης 200 και δεν αλλάζει τίποτα.

Σφάλματα

Κατάσταση	Πότε
403	Ο ρόλος του API key είναι viewer
404	Ο κώδικας δεν βρέθηκε στο Workspace
413	Το αρχείο είναι μεγαλύτερο από 1 MB
422	Το πεδίο file λείπει, ή πρόκειται για μορφή διαφορετική από PNG/JPEG/WebP (συμπεριλαμβανομένου του SVG)

Τι αλλάζει στον κώδικα

Τα αρχεία qr.svg και qr.png ενσωματώνουν τα πραγματικά pixel του λογοτύπου κεντραρισμένα, σε κλίμακα που αντιστοιχεί σε ένα σταθερό ποσοστό της επιφάνειας του κώδικα. Και τα δύο αυξάνουν τη διόρθωση σφαλμάτων στο H για αυτόν τον σκοπό, ώστε ο κώδικας να παραμένει σκανάσιμος. Τα αρχεία qr.pdf και qr.eps δεν επηρεάζονται από το λογότυπο – δεν ενσωματώνουν ποτέ λογότυπο και διατηρούν το μοτίβο που θα είχαν και χωρίς λογότυπο.

Tip

Η προσθήκη ενός λογοτύπου, εκεί όπου δεν είχε οριστεί προηγουμένως, ή η πλήρης κατάργηση αλλάζει το μοτίβο κουκκίδων του κώδικα (διόρθωση σφαλμάτων M ↔ H). Αντίθετα, η αντικατάσταση ενός υπάρχοντος λογοτύπου με μια άλλη εικόνα δεν αλλάζει το μοτίβο – η διόρθωση σφαλμάτων παραμένει H, αλλάζουν μόνο τα ενσωματωμένα pixel, ενώ η μήτρα (matrix) παραμένει πανομοιότυπη.

Προσωρινή αποθήκευση (Cache)

Όταν έχει οριστεί λογότυπο, τα αρχεία qr.svg/qr.png παρέχονται με την κεφαλίδα Cache-Control: public, max-age=300 (5 λεπτά) αντί για τη συνήθη public, max-age=86400, immutable (24 ώρες). Έτσι, ένα URL εικόνας που είναι ενσωματωμένο κάπου αλλού – σε μια σελίδα, σε ένα email, σε ένα έγγραφο – θα εμφανίσει την αλλαγή του λογοτύπου εντός έως και 5 λεπτών. Ένα αντίγραφο που είχε αποθηκευτεί στην προσωρινή μνήμη πριν ο κώδικας αποκτήσει ποτέ λογότυπο, μπορεί να χρειαστεί έως και 24 ολόκληρες ώρες για να ενημερωθεί, επειδή είχε αποθηκευτεί με τη μεγαλύτερη, αμετάβλητη διάρκεια ζωής.

Εκτύπωση

• Ένας ήδη εκτυπωμένος κώδικας συνεχίζει να λειτουργεί, ανεξάρτητα από το αν προστίθεται, αντικαθίσταται ή καταργείται ένα λογότυπο – ο κωδικοποιημένος προορισμός δεν εξαρτάται ποτέ από το λογότυπο.
• Η προσθήκη ή κατάργηση ενός λογοτύπου αλλάζει το μοτίβο κουκκίδων. Εάν το ίδιο το λογότυπο πρέπει να εμφανίζεται στο εκτυπωμένο υλικό, εκτυπώστε ξανά χρησιμοποιώντας το τρέχον qr.svg ή qr.png – μην αναμιγνύετε ποτέ παλιά και νέα αρχεία εκτύπωσης.
• Η αντικατάσταση ενός λογοτύπου δεν αλλάζει το μοτίβο· μια νέα εκτύπωση είναι τότε μόνο θέμα της επιθυμητής νέας εικόνας και όχι της δυνατότητας σάρωσης.
• Τα αρχεία qr.pdf και qr.eps δεν περιέχουν ποτέ λογότυπο. Για προσχέδια εκτύπωσης που πρέπει να δείχνουν το λογότυπο, κάντε λήψη του qr.svg ή του qr.png.
• Πριν από μια πλήρη εκτύπωση, κάντε πάντα μια δοκιμαστική σάρωση στο πραγματικό υλικό, ειδικά μετά από μια αλλαγή μοτίβου.

Σχετικά θέματα

• Μορφές λήψης
• Αρχεία & Φύλλα δεδομένων