MostlyQR

Verificación

Cualquiera — un comprador o un revendedor — puede verificar si una unidad serializada es genuina. La verificación es pública: el número de serie impreso es la credencial, por lo que no se necesita clave API. Lee el historial de escaneos real de la unidad + el resultado de detección de clones.

# La página de verificación

Apunta el código de una unidad (o su Digital Link de GS1) a:

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

Al escanearlo con cualquier cámara de teléfono (sin aplicación) se muestra un resultado genuino / marcado / no encontrado, el producto, lote y cualquier atributo de pasaporte digital. La página también puede leer QR, DataMatrix y Code 128 / EAN-13 con su escáner de cámara integrado.

# Verificación programática (invocable)

La superficie de verificación es una invocable pública de Firebase (no una ruta REST con clave Bearer), por lo que puede ser invocada desde un navegador sin clave:

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 es uno de:

Estado Significado
genuine Acuñado, activo, no marcado.
flagged Heurística de clonación activada, o la unidad/campaña fue revocada. reason/detail explican.
unknown No es un número de serie que emitimos (nunca acuñado o escrito incorrectamente) — tratar con precaución.

La carga útil public es una proyección segura de privacidad: producto, lote, región aproximada, conteo de escaneos y atributos de marca solamente — nunca cuenta, destino u registros de escaneo sin procesar.

# Verificación en lote de revendedores

Los distribuidores pueden verificar una lista de existencias completa a la vez en la página de verificación (“Verificar muchos”) o a través de la invocable en lote (hasta 200 números de serie, deduplicados; las entradas pueden ser números de serie simples, URL de verificación o Digital Links):

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

Devuelve una matriz de veredictos por número de serie más conteos — detecta existencias duplicadas o no emitidas antes de aceptar un pallet. La página ofrece una exportación CSV de los resultados.

# Pasaporte digital de producto

Una marca puede adjuntar atributos a una campaña (o por lote) — Modelo, Año de lanzamiento, Material, Origen… — que se renderizan en el resultado de verificación, convirtiendo la autenticidad en una página de procedencia (alineada con Digital Link de GS1 / la dirección DPP de la UE). Establécelos en la pestaña Serializado del panel, o a través de la API de campaña. Los atributos de lote anulan los atributos de campaña por etiqueta.

# Certificado de autenticidad

Un resultado genuino ofrece un certificado descargable (una imagen de marca generada en el navegador). Una versión PDF del servidor / en lote (a través de MostlyRender) está en la hoja de ruta.

# Siguiente