MostlyQR

Verifica

Chiunque — un cliente o un rivenditore — può verificare se un codice serializzato è autentico. La verifica è pubblica: il numero di serie stampato è la credenziale, quindi non è necessaria alcuna chiave API. Legge la cronologia delle scansioni reale dell’unità e il risultato del rilevamento dei cloni.

# La pagina di verifica

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

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

Scansionarlo con la fotocamera di qualsiasi telefono (nessuna app) mostra un risultato autentico / contrassegnato / non trovato, il prodotto, il lotto e tutti gli attributi del passaporto digitale. La pagina può anche leggere QR, DataMatrix e Code 128 / EAN-13 con il suo scanner fotocamera integrato.

# Controllo programmatico (callable)

La superficie di verifica è una Firebase callable pubblica (non una rotta REST con chiave Bearer), quindi può essere chiamata 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",
    "attributes": [ { "label": "Model", "value": "Single-origin Ethiopia" } ] } } }

status è uno di:

Stato Significato
genuine Emesso, attivo, non contrassegnato.
flagged Euristica dei cloni attivata, oppure l’unità/campagna è stata revocata. reason/detail spiegano.
unknown Non è un numero di serie che abbiamo emesso (mai emesso o digitato male) — trattare con cautela.

Il payload public è una proiezione sicura per la privacy: solo prodotto, lotto, regione approssimativa, conteggio delle scansioni e attributi del marchio — mai account, destinazione o registri di scansione non elaborati.

# Verifica in blocco per rivenditori

I distributori possono verificare un intero elenco di magazzino in una volta sulla pagina di verifica (“Verifica molti”) o tramite la callable in blocco (fino a 200 numeri di serie, deduplicati; le voci possono essere numeri di serie semplici, 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 di serie più conteggi — individua 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 di verifica, trasformando l’autenticità in una pagina di provenienza (allineata con GS1 Digital Link / la direzione DPP dell’UE). Impostali nella scheda Serialized del dashboard, o tramite l’API della campagna. Gli attributi del lotto sovrascrivono gli attributi della campagna per etichetta.

# Certificato di autenticità

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

# Avanti