Vérification
Quiconque — un client ou un revendeur — peut vérifier qu’une unité sérialisée est authentique. La vérification est publique : le numéro de série imprimé est la preuve d’identité, aucune clé API n’est nécessaire. Elle lit l’historique réel des scans de l’unité et le résultat de la détection de clones.
# La page de vérification
Pointez le code d’une unité (ou son GS1 Digital Link) vers :
https://mostlyqr.com/Verify?s=<serial>
Le scanner avec l’appareil photo de n’importe quel téléphone (pas d’application) affiche un résultat authentique / signalé / non trouvé, le produit, le lot et tous les attributs du passeport numérique de produit. La page peut aussi lire les codes QR, DataMatrix et Code 128 / EAN-13 avec son scanner de caméra intégré.
# Vérification programmatique (appelable)
La surface de vérification est une fonction appelable Firebase publique (pas une route REST avec clé Bearer), elle peut donc être appelée depuis un navigateur sans clé :
curl -X POST https://europe-west2-mostly-qr.cloudfunctions.net/verifyUnitCode \
-H "Content-Type: application/json" \
-d '{ "data": { "serial": "K0TKPSGN9AB" } }'
{ "result": {
"serial": "K0TKPSGN9AB",
"status": "genuine",
"reason": "ok",
"public": { "product": "Spring Roast 250g", "batch": "L-2027-04",
"region": "GB", "scan_count": 3,
"attributes": [ { "label": "Model", "value": "Single-origin Ethiopia" } ] } } }
status est l’un de :
| Statut | Signification |
|---|---|
genuine |
Créé, actif, non signalé. |
flagged |
L’heuristique de clonage a déclenché, ou l’unité/campagne a été révoquée. reason/detail expliquent. |
unknown |
Pas un numéro de série que nous avons émis (jamais créé, ou mal orthographié) — traiter avec prudence. |
Le payload public est une projection sûre pour la vie privée : produit, lot, région
approximative, nombre de scans et attributs de marque uniquement — jamais compte,
destination ou journaux de scan bruts.
# Vérification en masse pour revendeurs
Les distributeurs peuvent vérifier une liste de stock entière à la fois sur la page de vérification (« Vérifier plusieurs ») ou via la fonction appelable en masse (jusqu’à 200 numéros de série, dédupliqués ; les entrées peuvent être des numéros de série seuls, des URL de vérification ou des Digital Links) :
curl -X POST https://europe-west2-mostly-qr.cloudfunctions.net/verifyUnitsBulkCode \
-H "Content-Type: application/json" \
-d '{ "data": { "serials": ["K0TKPSGN9AB", "https://mostlyqr.com/Verify?s=ABCDEFGHJK7"] } }'
Retourne un tableau de verdict par numéro de série plus des décomptes — détectez les stocks dupliqués ou non émis avant d’accepter une palette. La page offre une exportation CSV des résultats.
# Passeport numérique de produit
Une marque peut joindre des attributs à une campagne (ou par lot) — Modèle, Année de lancement, Matériau, Origine… — qui s’affichent sur le résultat de vérification, transformant l’authenticité en page de provenance (alignée avec GS1 Digital Link / la direction de la DPP de l’UE). Définissez-les dans l’onglet Sérialisé du tableau de bord, ou via l’API de campagne. Les attributs de lot remplacent les attributs de campagne par libellé.
# Certificat d’authenticité
Un résultat authentique offre un certificat téléchargeable (une image de marque générée dans le navigateur). Une version PDF côté serveur / en masse (via MostlyRender) est sur la feuille de route.
# Suivant
- Codes sérialisés — comment créer les unités que cela vérifie.
- La référence API complète.