MostlyQR

Serialisierte Codes

Geben Sie jeder physischen Einheit ihren 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-Verifizierung. Enterprise-Plan.

Das Modell hat drei Ebenen:

  • Campaign — das Produkt/die SKU: ein Ziel + Marke + Status. Wird im Dashboard (Serialized-Tab) oder über die Dashboard-API erstellt.
  • Batch — eine Produktionscharge unter einer Campaign (wird zum Zeitpunkt der Prägung erstellt).
  • Unit — ein physischer Artikel, identifiziert durch seine Seriennummer (mqr.sh/<serial>).

# Batch prägen

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

# Prägejob abfragen

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 }

# Druckfertiges Bundle exportieren

Nach der Prägung erstellen Sie ein Manifest (CSV + optional JSONL jeder Seriennummer + ihre URL) und erhalten eine kurzfristig signierte Download-URL – übergeben Sie diese an Ihren Druck-/Verpackungslieferanten.

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 + Charge + Verfallsdatum + Seriennummer dargestellt werden. Sie können auch einen digitalen Produktpass (Modell, Erscheinungsjahr, Material…) anhängen, der bei der Verifizierung einer Unit angezeigt wird.

# Anti-Fälschung

Scans pro Unit führen eine Klon-Erkennungsheuristik aus (dieselbe Seriennummer, die in verteilten Geographien oder unmöglichen Reisen erscheint) und lösen einen clone.suspected Webhook bei Flaggenübergang aus. Verdikt-Oberflächen sind öffentlich über Verification verfügbar.

# Hinweise

  • Die Prägung ist an die Kontingent serialized_codes des Enterprise-Plans gebunden – ein Schlüssel ohne Enterprise (oder eine Prägung, die das Kontingent überschreiten würde) erhält 409 (failed-precondition), mit dem Limit in der Nachricht.
  • Units sind ultra-leichte Dokumente, daher skaliert eine Campaign bis zu Millionen ohne Pro-Unit-Overhead.

# Nächstes