MostlyQR

Verifica

Chiunque — un acquirente o un rivenditore — può verificare se un’unità serializzata è autentica. La verifica è pubblica: il numero seriale stampato è la credenziale, quindi non è necessaria alcuna chiave API. Legge la cronologia di scansione reale dell’unità + il risultato del rilevamento dei cloni.

# La pagina di verifica

Punta il codice di un’unità (o il suo GS1 Digital Link) a:

text
https://mostlyqr.com/Verify?s=<serial>

Scansionandolo con qualsiasi fotocamera del telefono (senza app) viene visualizzato un risultato autentico / contrassegnato / non trovato, il prodotto, il lotto e qualsiasi attributo del passaporto digitale del prodotto. La pagina può inoltre leggere codici QR, DataMatrix e Code 128 / EAN-13 con lo scanner della fotocamera integrato.

# Verifica programmatica (callable)

La superficie di verifica è un callable Firebase pubblico (non una rotta REST con chiave Bearer), quindi può essere chiamato da un browser senza chiave:

bash
curl -X POST https://europe-west2-mostly-qr.cloudfunctions.net/verifyUnitCode \
  -H "Content-Type: application/json" \
  -d '{ "data": { "serial": "K0TKPSGN9AB" } }'
json
{ "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 è uno di:

Status Significato
genuine Creato, attivo, non contrassegnato.
flagged L’euristica dei cloni è stata attivata, oppure l’unità/campagna è stata revocata. reason/detail spiegano.
unknown Non è un numero seriale che abbiamo emesso (mai creato, oppure digitato male) — trattare con cautela.

Il payload public è una proiezione sicura per la privacy: solo prodotto, lotto, regione generale, numero di scansioni e attributi del marchio — mai account, destinazione o log di scansione grezzi.

# Verifica in blocco per rivenditori

I distributori possono verificare un intero elenco di stock contemporaneamente sulla pagina di verifica (“Verifica molti”) o tramite il callable in blocco (fino a 200 numeri seriali, deduplicate; le voci possono essere semplici numeri seriali, URL di verifica o Digital Link):

bash
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"] } }'

Restituisce un array di verdetto per numero seriale più conteggi — rileva stock duplicato o non emesso prima di accettare un pallet. La pagina offre un’esportazione CSV dei risultati.

# Passaporto digitale del prodotto

Un marchio può allegare attributi a una campagna (o per lotto) — Modello, Anno di uscita, Materiale, Origine… — che vengono visualizzati sul risultato della verifica, trasformando l’autenticità in una pagina di provenienza (in linea con GS1 Digital Link / la direzione DPP dell’UE). Impostali nella scheda Serializzato del dashboard, oppure tramite l’API della campagna. Gli attributi del lotto sostituiscono gli attributi della campagna per etichetta.

# Certificato di autenticità

Un risultato autentico offre un certificato scaricabile (un’immagine con marchio generata nel browser). Una versione PDF lato server / in blocco (tramite MostlyRender) è nella roadmap.

# Avanti