TL;DR
- Un resolver GS1 Digital Link est le service web qui se trouve derrière le domaine d'un GS1 Digital Link. Il lit les identifiants d'une adresse scannée et envoie le lecteur vers la bonne destination : une page produit, un avis de rappel, un mode d'emploi ou des données lisibles par machine.
- Il répond à trois types de requête : un scan simple mène au lien par défaut, une requête pour un type de lien précis mène à ce lien, et une requête pour le linkset renvoie tous les liens qu'il détient pour le produit.
- Les resolvers peuvent être exploités par des marques, des organisations membres GS1, des distributeurs ou des prestataires de solutions. Comme chacun est indépendant et suit la même norme GS1, toute application conforme peut utiliser n'importe quel resolver.
Un resolver GS1 Digital Link est un serveur web qui relie un identifiant GS1, comme le GTIN d'un produit, aux informations qui le concernent en ligne. Lorsqu'un téléphone scanne un code QR GS1 Digital Link, la requête est envoyée au resolver situé sur le domaine du code. Le resolver vérifie l'adresse, trouve les liens enregistrés pour ce produit, ce lot ou cet article, et redirige vers celui qui correspond à la requête. C'est ce qui permet à un seul code de servir les acheteurs, les partenaires commerciaux et les systèmes, en donnant à chacun quelque chose de différent.
Le resolver en bref
| Ce que c'est | Un serveur web qui résout des identifiants GS1 en ressources en ligne |
| Entrée | Une URI GS1 Digital Link : domaine, clé primaire, qualificatifs et attributs |
| Sortie | Une redirection vers une destination, une liste de liens, ou une erreur qui explique pourquoi il n'y en a aucune |
| Qui l'exploite | Des marques, des organisations membres GS1, des distributeurs ou des prestataires de solutions |
| Norme | La spécification GS1 des resolvers conformes, aux côtés de la syntaxe d'URI GS1 Digital Link |
| Protocole | HTTPS, avec réponse aux requêtes GET, HEAD et OPTIONS, et CORS pour que les applications web puissent l'interroger |
Les trois façons d'interroger un resolver
| Requête | Ce que fait le resolver | Lecteur type |
|---|---|---|
| Un scan simple de l'adresse | Redirige vers le lien par défaut, généralement la page produit | Le téléphone d'un acheteur |
L'adresse avec un paramètre linkType, comme ?linkType=gs1:recallStatus | Redirige vers le lien de ce type, s'il en a un | Une application ou un partenaire commercial qui cherche quelque chose de précis |
L'adresse avec linkType=linkset | Renvoie la liste complète des liens qu'il détient pour cet identifiant, dans un format lisible par machine | Les systèmes et applications qui veulent découvrir tout ce qui est disponible |
Les liens peuvent aussi être choisis selon la langue et le contexte. Un acheteur en France peut être envoyé vers la page en français et un acheteur en Allemagne vers la page en allemand, à partir du même code.
Ce que fait un resolver à chaque requête
- Décompresser. Si le code porte la forme compressée que la norme autorise pour les petits symboles, le resolver la développe.
- Valider. Il vérifie la syntaxe : une clé primaire GS1 valide, des qualificatifs de clé dans le bon ordre et des attributs de données valides.
- Rechercher. Il trouve les liens enregistrés pour cet identifiant, au niveau le plus précis dont il dispose : article, lot ou produit.
- Choisir. Il sélectionne le lien qui correspond à la requête : le lien par défaut, le type de lien demandé ou le linkset.
- Répondre. Il renvoie une redirection, la liste des liens ou une erreur accompagnée d'une explication.
Les métadonnées enregistrées avec chaque lien
| Attribut | Obligatoire | Exemple |
|---|---|---|
| URL cible | Oui | L'adresse d'une page consacrée à ce produit, et non une page d'accueil ou des résultats de recherche |
| Type de lien | Oui | Une page d'informations produit, gs1:pip |
| Titre | Oui | « Informations produit », affiché lorsqu'une application liste les options |
| Langue | Non | en, fr, de |
| Type de média | Non | text/html pour une page, application/json pour des données |
| Contexte | Non | Un territoire ou un usage, pour un routage par marché |
Une cible peut porter plusieurs types de lien lorsqu'une même page remplit plusieurs rôles, par exemple une page produit qui affiche aussi les informations sur les allergènes.
Comment répond un resolver
| Situation | Réponse |
|---|---|
| Un lien correspondant existe | Une redirection vers ce lien (307 Temporary Redirect), le linkset étant exposé dans l'en-tête HTTP Link |
| Le resolver n'a pas d'information, mais un autre resolver peut en avoir | Une redirection vers le resolver alternatif (307) |
| Le resolver n'a pas d'information | 404 Not Found |
| Le resolver sait pourquoi il ne peut pas servir l'identifiant | 303 See Other, qui pointe vers une explication |
| L'adresse est mal formée | Une réponse d'erreur qui indique ce qui ne va pas |
Les valeurs de la chaîne de requête de l'adresse d'origine, comme la date de péremption, sont transmises telles quelles lorsque le resolver redirige. Chaque redirection supplémentaire rallonge l'attente de la personne qui scanne : les chaînes de resolvers doivent donc rester courtes.
Comment mettre en place un resolver GS1 Digital Link : cinq étapes
- Choisissez le domaine. Un sous-domaine qui vous appartient, comme
id.votremarque.com, garde les codes à vous quel que soit le prestataire qui exploite le resolver, et montre votre marque aux acheteurs dans l'adresse. - Développez-le ou passez par un prestataire. Avec assez de temps et de moyens techniques, n'importe qui peut développer un resolver conforme. Un prestataire vous en fournit un prêt à l'emploi. Dans les deux cas, vérifiez qu'il respecte la norme GS1 sur les resolvers, pour que toute application conforme puisse lire vos codes.
- Chargez vos produits et leurs liens par défaut. Ajoutez chaque GTIN avec sa destination par défaut, et ajoutez des entrées au niveau du lot ou de l'article lorsque vous avez besoin de destinations différentes, par exemple pour un rappel.
- Ajoutez les types de lien, les langues et le contexte. Donnez à chaque lien son type et son titre, ajoutez les versions linguistiques et routez par marché lorsque le contenu diffère.
- Testez chaque chemin. Vérifiez un scan simple, une requête pour chaque type de lien, le linkset, un GTIN inconnu et une adresse mal formée, puis surveillez les scans après le lancement. Le guide de dépannage indique quoi vérifier lorsqu'un code ne s'ouvre pas.
Le resolver de la plateforme Digital Link
Digital Link, la plateforme à l'origine de ce site, exploite un resolver conforme à la norme GS1 pour vos codes, sur son propre domaine ou sur votre sous-domaine grâce à un enregistrement CNAME. Chaque produit reçoit une destination par défaut, avec des versions par langue et par pays, et des variantes pour les lots ou les articles. Chaque lien peut être modifié à tout moment sans réimpression.
Créez votre premier code QR GS1 Digital Link
Foire aux questions
Qu'est-ce qu'un resolver GS1 Digital Link ?
Le service web qui se trouve derrière le domaine d'un GS1 Digital Link. Il lit les identifiants d'une adresse scannée, trouve les liens enregistrés pour ce produit, ce lot ou cet article, et redirige vers la destination qui correspond à la requête.
Qui exploite les resolvers GS1 Digital Link ?
Les marques, les organisations membres GS1, les distributeurs et les prestataires de solutions peuvent tous en exploiter un. Chacun est indépendant et, comme ils suivent la même norme GS1, une application peut interroger n'importe lequel d'entre eux.
Qu'est-ce qu'un type de lien ?
La catégorie d'une destination qu'un resolver peut proposer pour un produit, comme la page d'informations produit, gs1:pip, ou le statut de rappel, gs1:recallStatus. Une application demande un type de lien pour obtenir une ressource précise plutôt que la page par défaut.
Qu'est-ce qu'un linkset ?
La liste complète des liens qu'un resolver détient pour un identifiant, renvoyée dans un format lisible par machine lorsqu'une application demande linkType=linkset. Il permet aux systèmes de découvrir tout ce qui est disponible sur un produit.
Ai-je besoin de mon propre resolver ?
Il vous faut un resolver conforme derrière vos codes, mais pas forcément un resolver que vous avez développé. La plupart des marques passent par un prestataire et placent les codes sur leur propre sous-domaine pour qu'ils restent les leurs.
Une caisse utilise-t-elle le resolver ?
Non. Une caisse compatible 2D lit le GTIN, le lot et la date de péremption directement dans le code, sans internet. Seuls les téléphones et les applications qui ouvrent l'adresse atteignent le resolver.
