Geserialiseerde codes
Geef elk fysiek item zijn eigen unieke code — niet één code per productlijn, maar een afzonderlijke, niet-opsommingbare serienummer per item. Dat ontgrendelt analytics per eenheid, terugroepen, en anti-vervalsing verificatie. Enterprise-plan.
Het model heeft drie niveaus:
- Campaign — het product/SKU: een bestemming + merk + status. Gemaakt in het dashboard (tabblad Serialized) of via de dashboard-API.
- Batch — een productielot onder een campaign (gemaakt op munt-moment).
- Unit — één fysiek item, geïdentificeerd door zijn serienummer (
mqr.sh/u/<serial>).
# Mint een batch
count eenheden worden asynchronisch onder een campaign gemunt; u peilt de taak, vervolgens exporteert u een
printklaar manifest.
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" }'
{ "job_id": "mint_abc", "batch_id": "b-1718…", "total": 100000, "status": "queued" }
# Peilen van de mint-taak
curl https://mostlyqr.com/api/v1/serialized/jobs/mint_abc \
-H "Authorization: Bearer mtq_live_…"
{ "job_id": "mint_abc", "status": "running", "total": 100000, "minted": 42000, "progress": 0.42 }
# Een printklaar pakket exporteren
Eenmaal gemunt, bouwt u een manifest (CSV + optioneel JSONL van elk serienummer + zijn URL) en krijgt u een kortlevige ondertekende download-URL — geef deze aan uw druk-/verpakkingsleverancier.
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 }'
{ "url": "https://…signed…/spring-run-04.zip", "count": 100000, "filename": "spring-run-04.zip", "expires_in_ms": 86400000 }
# Symbologie & het productpaspoort
Elk serienummer kan als QR, een ECC200 DataMatrix (compacte verpakking), of een GS1 Digital Link met GTIN + batch + vervaldatum + serienummer worden weergegeven. U kunt ook een digitaal productpaspoort (Model, Productiejaar, Materiaal…) toevoegen dat wordt weergegeven wanneer een eenheid wordt geverifieerd.
# Anti-vervalsing
Per-eenheid-scans voeren een kloondetectieheuristiek uit (hetzelfde serienummer dat op verschillende
geografische locaties verschijnt, of onmogelijk reizen) en activeren een clone.suspected webhook op de vlagovergang. Uitspraken worden openbaar gemaakt via Verificatie.
# Opmerkingen
- Munten is afhankelijk van de
serialized_codestoewijzing van het Enterprise-plan — een niet-Enterprise- sleutel krijgt403. - Units zijn ultralight-documenten, dus een campaign schaalt tot miljoenen zonder per-eenheid overhead.
# Volgende
- Verificatie — de echo/gevlagde controle op een serienummer.
- De volledige API-referentie.