MostlyQR

Verificação

Qualquer pessoa — um cliente ou revendedor — pode verificar se uma unidade serializada é genuína. A verificação é pública: o número de série impresso é a credencial, portanto nenhuma chave de API é necessária. Ela lê o histórico real de digitalizações da unidade + o resultado da detecção de clones.

# A página de verificação

Aponte o código de uma unidade (ou seu GS1 Digital Link) para:

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

Ao digitalizá-lo com a câmera de qualquer smartphone (sem app), mostra um resultado genuíno / sinalizado / não encontrado, o produto, lote e qualquer atributo de passaporte. A página também pode ler QR, DataMatrix e Code 128 / EAN-13 com seu scanner de câmera integrado.

# Verificação programática (chamável)

A superfície de verificação é um callable público do Firebase (não uma rota REST com chave Bearer), portanto pode ser chamado de um navegador sem chave:

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 é um de:

Status Significado
genuine Cunhada, ativa, não sinalizada.
flagged Heurística de clone acionada, ou a unidade/campanha foi revogada. reason/detail explicam.
unknown Não é um número de série que emitimos (nunca cunhada, ou digitada incorretamente) — trate com cautela.

O payload public é uma projeção segura para privacidade: produto, lote, região aproximada, contagem de digitalizações e atributos de marca apenas — nunca conta, destino ou logs de digitalização brutos.

# Verificação em massa para revendedores

Distribuidores podem verificar uma lista de estoque inteira de uma vez na página de verificação (“Verify many”) ou via o callable em massa (até 200 números de série, desduplicados; as entradas podem ser números de série simples, URLs de verificação ou 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"] } }'

Retorna um array de veredicto por número de série mais contadores — detecte estoque duplicado ou não emitido antes de aceitar um pallet. A página oferece uma exportação CSV dos resultados.

# Passaporte digital do produto

Uma marca pode anexar atributos a uma campanha (ou por lote) — Modelo, Ano de lançamento, Material, Origem… — que são renderizados no resultado de verificação, transformando a autenticidade em uma página de proveniência (alinhada com GS1 Digital Link / a direção do DPP da UE). Defina-os na aba Serialized do painel, ou via a API de campanha. Os atributos de lote sobrescrevem os atributos de campanha por rótulo.

# Certificado de autenticidade

Um resultado genuíno oferece um certificado para download (uma imagem marcada gerada no navegador). Uma versão PDF do lado do servidor / em massa (via MostlyRender) está no roteiro.

# Próximo