Vérification
N’importe qui — un client ou un revendeur — peut vérifier si une unité sérialisée est authentique. La vérification est publique : le numéro de série imprimé est l’identifiant, donc 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 clone.
# La page de vérification
Pointez le code d’une unité (ou son Digital Link GS1) vers :
https://mostlyqr.com/Verify?s=<serial>
Le scanner avec n’importe quel appareil photo (sans application) affiche un résultat authentique / signalé / non trouvé, le produit, le lot et tout attribut de passeport numérique. La page peut également 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 callable Firebase publique (pas une route REST avec clé Bearer), donc elle peut ê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",
"attributes": [ { "label": "Model", "value": "Single-origin Ethiopia" } ] } } }
status est l’un des suivants :
| Statut | Signification |
|---|---|
genuine |
Créée, active, non signalée. |
flagged |
L’heuristique de détection de clone a été déclenchée, 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 saisi) — à traiter avec prudence. |
La charge public est une projection de sécurité conforme à la vie privée : produit, lot, région approximative, nombre de scans et attributs de marque uniquement — jamais compte, destination ou journaux bruts des scans.
# Vérification en masse par revendeur
Les distributeurs peuvent vérifier tout un inventaire à la fois sur la page de vérification (« Vérifier plusieurs ») ou via l’callable en masse (jusqu’à 200 numéros de série, dédupliqués ; les entrées peuvent être des numéros de série simples, 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 comptages — détectez les stocks dupliqués ou non émis avant d’accepter une palette. La page propose une exportation CSV des résultats.
# Passeport numérique du produit
Une marque peut joindre des attributs à une campagne (ou par lot) — Modèle, Année de sortie, Matière, Origine… — qui s’affichent sur le résultat de vérification, transformant l’authenticité en page de provenance (conforme au Digital Link GS1 / à 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 étiquette.
# 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.