GETMéthode GET/p/{serial}

Vous transformez le numéro de série d'un article en adresse de la page qui le présente à un consommateur, par une redirection.

#Autorisation

Aucune, point d'entrée public. Nous n'attendons ni clef d'API, ni cookie de session, ni en-tête Authorization. Vous pouvez appeler cette adresse depuis un serveur.

#Plafond d'appels

Cette adresse a un plafond dédié et appliqué de 60 appels par 60 secondes, compté par adresse IP appelante. Le compteur lui est propre : il porte sur tous les chemins /p/ confondus et n'est partagé avec aucune autre famille.

Prévoyez le code 429 dans votre client et respectez l'en-tête Retry-After qu'il porte. La valeur de ce compteur peut changer sans préavis, donc n'inscrivez aucun nombre en dur dans votre code.

La réponse porte les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset, ce dernier donnant l'heure de remise à zéro en secondes depuis le 1er janvier 1970. Ne faites pas dépendre votre client de leur présence : traitez une réponse qui ne les porte pas comme une réponse normale, et fondez votre rythme d'appel sur les valeurs que vous recevez.

Cette adresse ne consomme aucun quota de votre offre.

#Paramètres de chemin et de requête

Ce numéro de série est l'identifiant unique de produit au sens de la norme EN 18219, celui que le registre européen des passeports numériques attend, et celui qu'encode le QR code imprimé sur vos articles. C'est votre marque qui déclare cet identifiant au registre, en tant qu'opérateur économique vérifié. SealTrust prépare le fichier que vous y déposez, voir Conformité.

Ce point d'entrée adresse un exemplaire physique. Un passeport n'a pas besoin de porter sur un exemplaire : le règlement ESPR prévoit trois niveaux, le modèle, le lot et l'article. Nous servons les trois. Pour un passeport de modèle, l'identifiant à utiliser est GET /01/{gtin}, qui résout le passeport de référence partagé par tous les exemplaires qui portent le même code produit. Pour un passeport de lot, c'est GET /01/{gtin}/10/{lot}. Vous n'avez donc pas à numéroter chaque exemplaire pour publier un passeport.

Le numéro de série s'écrit dans un alphabet de 32 caractères : les chiffres de 0 à 9 et les lettres de A à Z, sauf I, L, O et U. Ces quatre lettres sont écartées parce qu'elles se confondent avec des chiffres sur une étiquette.

Avant toute recherche, nous nettoyons la valeur reçue : nous retirons les espaces de bord, nous remplaçons I et L par 1, O par 0, et nous passons le tout en majuscules. Une personne qui recopie un numéro à la main peut donc se tromper sur I, L et O sans conséquence. Nous comprenons ilo2345678ab comme 1102345678AB, et c'est cette forme corrigée qui apparaît dans l'adresse de destination. La lettre U n'est pas corrigée : une valeur qui en contient part en 404.

Après ce nettoyage, nous refusons en 404 toute valeur qui ne fait pas exactement 12 caractères, ou qui contient un caractère hors de l'alphabet. Les paramètres d'authentification que certaines puces NFC ajoutent à l'adresse au moment du scan sont des paramètres de requête : nous ne les lisons pas ici et ils ne changent rien à la réponse.

#Corps de la requête

Aucun. C'est une requête GET : tout passe par le chemin et les paramètres de requête.

curl -i https://api.sealtrust.io/v1/p/000000000000 \
  -H "Accept-Language: fr"

const response = await fetch("https://api.sealtrust.io/v1/p/000000000000", {
  headers: { "Accept-Language": "fr" },
  redirect: "manual",
});

console.log(response.status);
console.log(response.headers.get("Location"));

import requests

response = requests.get(
    "https://api.sealtrust.io/v1/p/000000000000",
    headers={"Accept-Language": "fr"},
    allow_redirects=False,
    timeout=30,
)

print(response.status_code)
print(response.headers["Location"])

HTTP/1.1 302 Found
Location: https://sealtrust.io/en/product/000000000000

HTTP/1.1 302 Found
Location: https://sealtrust.io/en/product/000000000000

HTTP/1.1 302 Found
Location: https://sealtrust.io/fr/passport/0x0000000000000000000000000000000000000000000000000000000000000000