Verificatie
Iedereen — een koper of wederverkoper — kan controleren of een geserialiseerde eenheid echt is. Verificatie is openbaar: de gedrukte serienummer is de legitimatie, dus er is geen API-sleutel nodig. Het leest de werkelijke scangeschiedenis van de eenheid + het resultaat van kloondetectie.
# De verificatiepagina
Wijs de code van een eenheid (of de GS1 Digital Link) naar:
https://mostlyqr.com/Verify?s=<serial>
Het scannen ervan met een willekeurige telefooncamera (geen app) toont een echt / gemarkeerd / niet gevonden resultaat, het product, batch en eventuele paspoortattributen. De pagina kan ook QR, DataMatrix en Code 128 / EAN-13 lezen met de ingebouwde camerascanner.
# Programmatische controle (aanroepbaar)
Het verificatieoppervlak is een openbare Firebase callable (geen Bearer-sleutel REST-route), dus het 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",
"region": "GB", "scan_count": 3,
"attributes": [ { "label": "Model", "value": "Single-origin Ethiopia" } ] } } }
status is een van:
| Status | Betekenis |
|---|---|
genuine |
Aangemaakt, actief, niet gemarkeerd. |
flagged |
Kloonheuristiek geactiveerd, of de eenheid/campagne is ingetrokken. reason/detail leggen uit. |
unknown |
Geen serienummer dat wij hebben uitgegeven (nooit aangemaakt, of verkeerd getypt) — behandel voorzichtig. |
De public payload is een privacyveilige projectie: alleen product, batch, grove regio, scancount en merkattributen — nooit account, bestemming of onbewerkte scanlogboeken.
# Bulk verificatie voor wederverkopers
Distributeurs kunnen een hele voorraadlijst tegelijk op de verificatiepagina (“Verify many”) of via de bulk-aanroepbare functie controleren (tot 200 serienummers, gededupliceerd; invoeren kunnen bare serienummers, 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-serienummer verdictvector plus aantallen — detecteer dubbelen of niet-uitgegeven voorraad voordat je een pallet accepteert. De pagina biedt een CSV-export van de resultaten.
# Digitaal productpaspoort
Een merk kan attributen aan een campagne (of per batch) toevoegen — Model, Releasejaar, Materiaal, Herkomst… — die op het verificatieresultaat worden weergegeven, waardoor authenticiteit in een herkomstpagina wordt omgezet (afgestemd op GS1 Digital Link / de EU DPP-richting). Stel ze in op het tabblad Geserialiseerd in het dashboard, of via de campagne-API. Batchattributen overschrijven campagneattributen op label.
# Authenticiteitscertificaat
Een authentiek resultaat biedt een downloadbaar certificaat (een in de browser gegenereerde afbeelding met merkgegevens). Een server-side / bulkversie in PDF (via MostlyRender) staat op de routekaart.
# Volgende
- Geserialiseerde codes — hoe u de eenheden aanmaakt die dit controleert.
- De volledige API-referentie.