Verificatie
Iedereen — een klant of een reseller — kan controleren of een geserialiseerde unit echt is. Verificatie is openbaar: de afgedrukte seriewaarde is de referentie, dus geen API-sleutel nodig. Het leest de werkelijke scangeschiedenis van de unit + het resultaat van kloondetectie.
# De verificatiepagina
Wijs een code van een unit (of de GS1 Digital Link ervan) naar:
https://mostlyqr.com/Verify?s=<serial>
Door het met elke telefoonkamera te scannen (geen app) verschijnt een echt / gemarkeerd / niet gevonden resultaat, het product, batch en eventuele paspoortkenmerken. De pagina kan ook QR, DataMatrix en Code 128 / EAN-13 lezen met de ingebouwde camera-scanner.
# Programmatische controle (callable)
Het verificatieoppervlak is een openbare Firebase callable (geen Bearer-sleutel REST-route), dus kan vanuit een browser zonder sleutel worden aangeroepen:
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 is een van:
| Status | Betekenis |
|---|---|
genuine |
Aangemaakt, actief, niet gemarkeerd. |
flagged |
Kloonheuristiek geactiveerd, of de unit/campagne is ingetrokken. reason/detail geven uitleg. |
unknown |
Geen seriewaarde die we hebben uitgegeven (nooit aangemaakt of verkeerd getypt) — behandel voorzichtig. |
De public payload is een privacyveilige projectie: product, batch, grove regio, scanaantal en merkkenmerken alleen — nooit account, bestemming of ruwe scanlogs.
# Reseller bulkverificatie
Distributeurs kunnen één keer een hele voorraadlijst controleren op de verificatiepagina (“Verify many”) of via de bulk callable (tot 200 seriewaarden, gededupliceerd; vermeldingen kunnen losse seriewaarden, verificatie-URL’s of Digital Links zijn):
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"] } }'
Retourneert een per-seriewaarde-uitspraak array plus aantallen — ontdek gededupliceerde of niet-uitgegeven voorraad vóór het accepteren van een pallet. De pagina biedt een CSV-export van de resultaten.
# Digitaal productpaspoort
Een merk kan kenmerken aan een campagne (of per batch) koppelen — Model, Releasejaar, Materiaal, Oorsprong… — die op het verificatieresultaat worden weergegeven, waardoor authenticiteit in een herkomstpagina verandert (afgestemd op GS1 Digital Link / de EU DPP-richting). Stel ze in het Serialized-tabblad van het dashboard in of via de campagne-API. Batchkenmerken overschrijven campagnekenmerken op label.
# Authenticiteitscertificaat
Een echt resultaat biedt een downloadbaar certificaat (een afbeelding die in de browser wordt gegenereerd). Een server-side / bulk PDF-versie (via MostlyRender) staat op de routekaart.
# Volgende
- Geserialiseerde codes — hoe de units die dit controleert worden aangemaakt.
- De volledige API-referentie.