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 n'a pas de plafond propre. Elle relève du compteur général de l'API, compté par adresse IP appelante sur une fenêtre de 60 secondes, et partagé avec toutes les autres adresses qui n'ont pas de plafond propre.

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. Le registre européen n'accepte aujourd'hui aucun enregistrement, de la part de personne. Nous soumettrons cet identifiant dès que son enregistrement sera ouvert.

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 aujourd'hui le niveau modèle et le niveau article. 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. 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/fr/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