Verifizierung
Jeder — ein Käufer oder ein Wiederverkäufer — kann überprüfen, ob eine serialisierte Einheit authentisch ist. Die Verifizierung ist öffentlich: Die gedruckte Seriennummer ist die Berechtigung, daher ist kein API-Schlüssel erforderlich. Sie liest den echten Scan-Verlauf der Einheit + das Clone-Erkennungsergebnis.
# Die Verifizierungsseite
Richten Sie den Code einer Einheit (oder ihren GS1 Digital Link) auf:
https://mostlyqr.com/Verify?s=<serial>
Das Scannen mit einer beliebigen Handykamera (keine App) zeigt ein genuine / flagged / not-found Ergebnis, das Produkt, den Batch und alle Passport-Attribute. Die Seite kann auch QR, DataMatrix und Code 128 / EAN-13 mit ihrem integrierten Kamera-Scanner lesen.
# Programmgesteuerte Überprüfung (aufrufbar)
Die Verifizierungsoberfläche ist eine öffentliche Firebase callable (keine Bearer-Key-REST-Route), daher kann sie von einem Browser ohne Schlüssel aufgerufen werden:
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 ist einer von:
| Status | Bedeutung |
|---|---|
genuine |
Geprägt, aktiv, nicht gekennzeichnet. |
flagged |
Clone-Heuristik ausgelöst, oder die Einheit/Kampagne wurde widerrufen. reason/detail erklären dies. |
unknown |
Keine Seriennummer, die wir ausgegeben haben (nie geprägt oder falsch eingegeben) — vorsichtig behandeln. |
Die public Payload ist eine datenschutzsichere Projektion: nur Produkt, Batch, grobe Region, Scan-Anzahl und Brand-Attribute — niemals Konto, Ziel oder rohe Scan-Protokolle.
# Wiederverkäufer-Massenverifizierung
Distributoren können eine ganze Bestandsliste auf der Verifizierungsseite (“Verify many”) oder über die Massen-Callable (bis zu 200 Seriennummern, dedupliziert; Einträge können einfache Seriennummern, Verifizierungs-URLs oder Digital Links sein) auf einmal überprüfen:
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"] } }'
Gibt ein Pro-Seriennummern-Urteil-Array sowie Zählungen zurück — erkennen Sie doppelte oder nicht ausgegebene Bestände, bevor Sie eine Palette akzeptieren. Die Seite bietet einen CSV-Export der Ergebnisse.
# Digitales Produktpass
Eine Marke kann Attribute an eine Kampagne (oder pro Batch) anhängen — Model, Freigabejahr, Material, Herkunft… — die auf dem Verifizierungsergebnis angezeigt werden und Authentizität in eine Herkunftsseite umwandeln (gemäß GS1 Digital Link / der EU-DPP-Richtung). Legen Sie diese im Dashboard-Tab Serialized fest oder über die Kampagnen-API. Batch-Attribute überschreiben Kampagnen-Attribute nach Label.
# Echtheitszertifikat
Ein echtes Ergebnis bietet ein herunterladbares Zertifikat (ein im Browser generiertes Markenbild). Eine serverseitige / Massen-PDF-Version (über MostlyRender) steht auf der Roadmap.
# Nächstes
- Serialisierte Codes — wie die Einheiten geprägt werden, die dies überprüft.
- Die vollständige API-Referenz.