3 λεπτά ανάγνωσης Tutorials gs1-digital-link resolver dpp gtin json-ld

Ο GS1 Digital Link Resolver, με απλά λόγια (και ένα ζωντανό παράδειγμα)

Ένας κωδικός QR DPP δεν είναι σύνδεσμος προς μια ιστοσελίδα — είναι ένα GS1 Digital Link, και ο resolver μετατρέπει ένα αναγνωριστικό σε πολλές απαντήσεις προσαρμοσμένες στο εκάστοτε πλαίσιο. Δείτε πώς λειτουργεί, με ένα ζωντανό passport που μπορείτε να καλέσετε με curl αυτή τη στιγμή.

από QR3 Redaktion

Ο GS1 Digital Link Resolver, με απλά λόγια (και ένα ζωντανό παράδειγμα)

Οι περισσότερες επεξηγήσεις σχετικά με τους κωδικούς QR του Ψηφιακού Διαβατηρίου Προϊόντος σταματούν στο «σαρώστε τον κωδικό, ανοίξτε έναν ιστότοπο». Αυτό όμως παραλείπει το ενδιαφέρον κομμάτι. Ο κωδικός QR σε ένα συμμορφούμενο προϊόν κωδικοποιεί ένα GS1 Digital Link, και το στοιχείο που το κάνει χρήσιμο είναι ο resolver — η υπηρεσία που μετατρέπει ένα αναγνωριστικό προϊόντος σε πολλές διαφορετικές απαντήσεις, προσαρμοσμένες στο εκάστοτε πλαίσιο.

Αυτό το άρθρο δείχνει τι κάνει στην πραγματικότητα ο resolver, με ένα ζωντανό passport που μπορείτε να καλέσετε αυτή τη στιγμή (χωρίς εγγραφή, χωρίς κλειδί).

Ένα GS1 Digital Link είναι μια κανονική διεύθυνση URL HTTPS που ενσωματώνει αναγνωριστικά GS1 ως τμήματα της διαδρομής (path segments), καθένα από τα οποία επισημαίνεται με ένα Application Identifier (AI):

https://id.gs1.org/01/04019999999902/21/DEMO-BAT-01
                   └─01─┘ └──GTIN───┘ └21┘ └─serial─┘
  • 01 → GTIN (Global Trade Item Number) — ποιο προϊόν
  • 21 → σειριακός αριθμός — ποια συγκεκριμένη μονάδα
  • 10 → παρτίδα/lot (εναλλακτική του σειριακού αριθμού)

Επειδή είναι μια απλή διεύθυνση URL, οποιαδήποτε κάμερα κινητού την ανοίγει. Επειδή είναι δομημένη, οι μηχανές μπορούν να την αναλύσουν. Αυτή η διττή φύση είναι ολόκληρο το νόημα.

Ο resolver: ένα URI, πολλές απαντήσεις

Ένας απλοϊκός κωδικός QR επιστρέφει μία σταθερή σελίδα. Ένας resolver εξετάζει το αίτημα και επιστρέφει την αναπαράσταση που ταιριάζει στον καλούντα:

  • ένας καταναλωτής με πρόγραμμα περιήγησης σε κινητό λαμβάνει μια αναγνώσιμη από άνθρωπο σελίδα HTML·
  • το σύστημα ενός ανακυκλωτή ζητά JSON-LD και λαμβάνει δομημένα δεδομένα αναγνώσιμα από μηχανές·
  • μια αρχή μπορεί να ζητήσει το πλήρες linkset — κάθε τυποποιημένο σύνδεσμο που εκθέτει το προϊόν.

Ίδια διεύθυνση URL, διαφορετικές απαντήσεις, που καθορίζονται από την κεφαλίδα Accept (ή μια παράκαμψη ?format=).

Ένας ζωντανός resolver που μπορείτε να καλέσετε αυτή τη στιγμή

Το qr3.app φιλοξενεί ένα δημόσιο demo passport μπαταρίας. Ανοίξτε το σε ένα πρόγραμμα περιήγησης:

https://qr3.app/dpp/04019999999902/DEMO-BAT-01

Θα δείτε τη σελίδα καταναλωτή για το EcoMax 5000 (Demo) της GreenPower GmbH. Τώρα ζητήστε από την ίδια διεύθυνση URL JSON-LD αναγνώσιμο από μηχανές:

curl "https://qr3.app/dpp/04019999999902/DEMO-BAT-01?format=jsonld"
{
  "@context": ["https://schema.org", "https://gs1.org/voc/"],
  "@type": "Product",
  "gtin": "04019999999902",
  "name": "EcoMax 5000 (Demo)"
}

Αυτό είναι ο resolver που κάνει τη δουλειά του: ένα αναγνωριστικό, μια ανθρώπινη σελίδα και ένα έγγραφο JSON-LD χτισμένο πάνω στο schema.org + το web vocabulary της GS1. Άλλες αναπαραστάσεις είναι διαθέσιμες με τον ίδιο τρόπο — ?format=json (ακατέργαστο passport), ?format=linkset (όλοι οι τυποποιημένοι σύνδεσμοι), ?format=dcat-ap — ή μέσω τυπικής διαπραγμάτευσης Accept (Accept: application/ld+json).

Ένας resolver είναι τόσο αξιόπιστος όσο και τα αναγνωριστικά που βρίσκονται πίσω από αυτόν. Επικυρώστε ένα GTIN πριν χτίσετε ένα Digital Link για αυτό:

import { QR3 } from "@qr3/sdk";

const client = new QR3({ apiKey: process.env.QR3_API_KEY! });

const result = await client.gs1.validateGs1({
  identifier_type: "gtin",
  value: "04019999999902",
});

console.log(result.valid);   // true
console.log(result.detail);  // "Valid GTIN-14"

Καταχωρίστε τα GTIN σας

Διατηρήστε τα αναγνωριστικά που χρησιμοποιείτε υπό διαχείριση, ώστε κάθε Digital Link να ανάγεται σε ένα γνωστό προϊόν:

const gtin = await client.gs1.createGs1Identifier({
  identifier_type: "gtin", // or "gln" | "company_prefix"
  value: "04019999999902",
  label: "EcoMax 5000",
});

Χρήση του qr3 ως resolver σας

Δεν χρειάζεται να χτίσετε και να λειτουργήσετε εσείς οι ίδιοι έναν resolver. Στρέψτε τον κωδικό QR του προϊόντος σας στο Digital Link, φιλοξενήστε το passport στο qr3.app, και ο resolver παρέχει τη σωστή αναπαράσταση ανά αίτημα. Το GTIN/serial στη διεύθυνση URL παραμένουν σταθερά για πάντα (ώστε οι εκτυπωμένες ετικέτες να μην χαλάνε ποτέ), ενώ τα δεδομένα πίσω από αυτά παραμένουν ενημερώσιμα.

Συχνές ερωτήσεις

Είναι ο ίδιος ο κωδικός QR διαφορετικός από έναν κανονικό; Όχι — είναι ένας τυπικός κωδικός QR (ή Data Matrix) που μεταφέρει μια διεύθυνση URL GS1 Digital Link. Οποιαδήποτε κάμερα τον ανοίγει· η ευφυΐα βρίσκεται στον resolver, όχι στο σύμβολο.

Λαμβάνουν πραγματικά οι καταναλωτές και οι ανακυκλωτές διαφορετικό περιεχόμενο; Ναι — αυτό είναι διαπραγμάτευση περιεχομένου (content negotiation). Το πρόγραμμα περιήγησης λαμβάνει HTML· ένα σύστημα που ζητά application/ld+json?format=jsonld) λαμβάνει δομημένα δεδομένα από την ίδια διεύθυνση URL.

Μπορώ να διατηρήσω τη δική μου σελίδα προϊόντος και να παραμείνω συμμορφούμενος; Ναι. Το Digital Link μπορεί να εκθέσει πολλαπλούς τυποποιημένους συνδέσμους (ένα linkset) — τη σελίδα μάρκετινγκ σας, το επίσημο passport, ένα τεχνικό δελτίο ανακύκλωσης — καθένα επισημασμένο με έναν τύπο συνδέσμου.

Πηγές

Δοκιμάστε το ζωντανό passport παραπάνω, και στη συνέχεια ξεκινήστε δωρεάν και κάντε resolve το δικό σας.

Σχετικά άρθρα