MostlyQR

Geserialiseerde codes

Geef elke fysieke eenheid een eigen unieke code — niet één code per productlijn, maar een duidelijk, niet-optelbare serieummer per artikel. Dit ontgrendelt per-eenheid analytics, terugroep, en anti-vervalsings verificatie. Enterprise plan.

Het model heeft drie lagen:

  • Campaign — het product/SKU: een bestemming + merk + status. Gemaakt in het dashboard (Serialized-tabblad) of via de dashboard API.
  • Batch — een productielot onder een campagne (gemaakt op mint-moment).
  • Unit — één fysiek artikel, geïdentificeerd door zijn serieummer (mqr.sh/<serial>).

# Mint een batch

count eenheden worden asynchroon geminted onder een campagne; u pollt de taak, vervolgens exporteert u een printklaar manifest.

bash
curl https://mostlyqr.com/api/v1/serialized/campaigns/CAMPAIGN_ID/mint \
  -H "Authorization: Bearer mtq_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "count": 100000, "label": "Spring run 04" }'
json
{ "job_id": "9f3a2c7b", "batch_id": "b-1718…", "total": 100000, "status": "queued" }

# Poll de mint-taak

bash
curl https://mostlyqr.com/api/v1/serialized/jobs/9f3a2c7b \
  -H "Authorization: Bearer mtq_live_…"
json
{ "job_id": "9f3a2c7b", "status": "running", "total": 100000, "minted": 42000, "progress": 0.42 }

# Exporteer een printklaar pakket

Eenmaal geminted, stelt u een manifest samen (CSV + optioneel JSONL van elk serieummer + bijbehorende URL) en haalt u een kortstondige ondertekende download-URL op — geeft u deze aan uw print-/verpakkingsleverancier.

bash
curl https://mostlyqr.com/api/v1/serialized/campaigns/CAMPAIGN_ID/export \
  -H "Authorization: Bearer mtq_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "batch_id": "b-1718…", "includeJsonl": true }'
json
{ "url": "https://…signed…/spring-run-04.zip", "count": 100000, "filename": "spring-run-04.zip", "expires_in_ms": 86400000 }

# Symbologie & het productpaspoort

Elk serieummer kan worden weergegeven als een QR, een ECC200 DataMatrix (compacte verpakking), of een GS1 Digital Link met GTIN + batch + vervaldatum + serieummer. U kunt ook een digitaal productpaspoort (Model, Uitvoeringsjaar, Materiaal…) toevoegen dat wordt getoond wanneer een eenheid wordt geverifieerd.

# Anti-vervalsing

Per-eenheid scans voeren een clone-detectie-heuristiek uit (hetzelfde serieummer verschijnt in verspreide geografieën, of onmogelijk reizen) en activeren een clone.suspected webhook bij de vlagovergang. Vonnissen worden openbaar weergegeven via Verification.

# Opmerkingen

  • Minting is afhankelijk van het Enterprise-plan’s serialized_codes toewijzing — een niet-Enterprise sleutel (of een mint die de toewijzing zou overschrijden) krijgt 409 (failed-precondition), met de limiet in het bericht.
  • Eenheden zijn ultraleichte documenten, dus een campagne schaalt tot miljoenen zonder per-eenheid overhead.

# Volgende