MostlyQR

Verificação

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

# A página de verificação

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

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

Digitalizá-lo com qualquer câmera de telefone (sem aplicativo) mostra um resultado genuíno / sinalizado / não encontrado, o produto, lote e quaisquer atributos do passaporte digital. 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 é uma callable Firebase pública (não uma rota REST com chave Bearer), portanto pode ser chamada 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",
    "region": "GB", "scan_count": 3,
    "attributes": [ { "label": "Model", "value": "Single-origin Ethiopia" } ] } } }

status é um dos seguintes:

Status Significado
genuine Cunhado, ativo, não sinalizado.
flagged Heurística de clone acionada, ou a unidade/campanha foi revogada. reason/detail explicam.
unknown Não é um serial que emitimos (nunca cunhado ou digitado incorretamente) — trate com cuidado.

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

# Verificação em massa do revendedor

Os distribuidores podem verificar uma lista de estoque inteira de uma vez na página de verificação (“Verificar muitos”) ou via a callable em massa (até 200 seriais, desduplicados; as entradas podem ser seriais 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 veredito por serial mais contagens — identifique estoque duplicado ou não emitido antes de aceitar um palete. A página oferece uma exportação CSV dos resultados.

# Passaporte digital de produto

Uma marca pode anexar atributos a uma campanha (ou por lote) — Modelo, Ano de lançamento, Material, Origem… — que aparecem no resultado de verificação, transformando autenticidade em uma página de proveniência (alinhada com Digital Link GS1 / a direção DPP da UE). Defina-os no painel da guia Serialized ou via a API de campanha. Os atributos de lote substituem 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 roadmap.

# Próximo