Λογότυπο στον κώδικα 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, qr.pdf και qr.eps – ενσωματώνουν τα πραγματικά pixel του λογοτύπου κεντραρισμένα, σε κλίμακα που αντιστοιχεί σε ένα σταθερό ποσοστό της επιφάνειας του κώδικα. Και τα τέσσερα αυξάνουν τη διόρθωση σφαλμάτων στο H για αυτόν τον σκοπό, ώστε ο κώδικας να παραμένει σκανάσιμος.

Tip

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

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

Όταν έχει οριστεί λογότυπο, και οι τέσσερις μορφές – qr.svg, qr.png, qr.pdf και qr.eps – παρέχονται με την κεφαλίδα 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) – μην αναμιγνύετε ποτέ παλιά και νέα αρχεία εκτύπωσης.
• Η αντικατάσταση ενός λογοτύπου δεν αλλάζει το μοτίβο· μια νέα εκτύπωση είναι τότε μόνο θέμα της επιθυμητής νέας εικόνας και όχι της δυνατότητας σάρωσης.
• Και τα τέσσερα φορμά περιέχουν τώρα το λογότυπο εξίσου – το ποιο φορμά είναι κατάλληλο για το δικό σας προσχέδιο εκτύπωσης εξαρτάται αποκλειστικά από το πρόγραμμα σελιδοποίησης (διανυσματικό για PDF/EPS, ψηφιογραφικό για PNG, SVG και για τα δύο).
• Πριν από μια πλήρη εκτύπωση, κάντε πάντα μια δοκιμαστική σάρωση στο πραγματικό υλικό, ειδικά μετά από μια αλλαγή μοτίβου, και μην αναμιγνύετε ποτέ αρχεία από διαφορετικές εκδόσεις.

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

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