MostlyQR

Serialisierte Codes

Geben Sie jedem physischen Objekt seinen eigenen eindeutigen Code — nicht einen Code pro Produktlinie, sondern eine unterschiedliche, nicht aufzählbare Seriennummer pro Artikel. Dies ermöglicht Analysen pro Einheit, Rückrufe und Anti-Fälschungs-Verifikation. Enterprise-Plan.

Das Modell hat drei Ebenen:

  • Campaign — das Produkt/die SKU: ein Ziel + Marke + Status. Wird im Dashboard (Registerkarte „Serialized") oder über die Dashboard-API erstellt.
  • Batch — ein Produktionslos unter einer Campaign (erstellt zum Zeitpunkt des Prägens).
  • Unit — ein physisches Objekt, identifiziert durch seine Seriennummer (mqr.sh/u/<serial>).

# Batch prägen

count Einheiten werden asynchron unter einer Campaign geprägt; Sie fragen den Job ab, dann exportieren Sie ein druckfertiges 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": "mint_abc", "batch_id": "b-1718…", "total": 100000, "status": "queued" }

# Mint-Job abfragen

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

# Druckfertiges Bundle exportieren

Nach dem Prägen erstellen Sie ein Manifest (CSV + optionales JSONL jeder Seriennummer + deren URL) und erhalten eine kurzfristig signierte Download-URL — übergeben Sie diese an Ihren Druck-/Verpackungsanbieter.

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 & digitaler Produktpass

Jede Seriennummer kann als QR-Code, als ECC200 DataMatrix (kompakte Verpackung) oder als GS1 Digital Link mit GTIN + Batch + Verfallsdatum + Seriennummer dargestellt werden. Sie können auch einen digitalen Produktpass (Modell, Erscheinungsjahr, Material…) anhängen, der bei der Verifikation einer Einheit angezeigt wird.

# Anti-Fälschung

Scans pro Einheit führen eine Clone-Detection-Heuristik aus (dieselbe Seriennummer an zerstreuten Standorten oder unmöglicher Reiseweg) und aktivieren einen clone.suspected-Webhook beim Flaggen-Übergang. Verdikt werden öffentlich über Verification angezeigt.

# Hinweise

  • Das Prägen ist an die serialized_codes-Zuteilung des Enterprise-Plans gebunden — ein Nicht-Enterprise-Schlüssel erhält 403.
  • Units sind Ultra-Light-Dokumente, daher skaliert eine Campaign ohne Pro-Unit-Overhead auf Millionen.

# Weiter