MostlyQR

シリアル化されたコード

すべての物理ユニットに一意のコードを付与する — 製品ラインごとに1つのコードではなく、列挙不可能な個別の serial です。これにより、ユニットごとの分析、リコール、および anti-counterfeit verification が可能になります。 Enterprise プランです。

モデルは3つのティアで構成されています：

  • Campaign — 製品/SKU：目的地 + ブランド + ステータス。ダッシュボード（Serialized タブ）またはダッシュボード API から作成されます。
  • Batch — キャンペーン配下の production lot （mint 時に作成）。
  • Unit — 1つの物理アイテム。serial（mqr.sh/<serial>）で識別されます。

# Mint a batch

count 個のユニットがキャンペーン配下で非同期に mint されます。ジョブをポーリングしてから、印刷可能なマニフェストをエクスポートします。

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 the mint job

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 }

# Export a print-ready bundle

Mint 後、マニフェスト（CSV + すべての serial とその URL の optional JSONL）を構築し、短期有効な署名付きダウンロード URL を取得します — 印刷/パッケージングベンダーに渡してください。

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 }

# Symbology & the product passport

各 serial は QR、ECC200 DataMatrix（緊密なパッケージング）、または GTIN + batch + expiry + serial を含む GS1 Digital Link としてレンダリングできます。また、digital product passport（Model、Release year、Material…）を添付することもでき、ユニットが検証されるときに表示されます。

# Anti-counterfeit

ユニットごとのスキャンは clone-detection ヒューリスティック（同じ serial が分散した地理的場所に出現する、または不可能な移動）を実行し、フラグ遷移で clone.suspected webhook を発火させます。評決は Verification を通じて公開されます。

# Notes

  • Minting は Enterprise プランの serialized_codes allotment に制限されています — non-Enterprise キー（または allotment を超える mint）は 409（failed-precondition）を取得し、メッセージに制限が含まれます。
  • ユニットは ultra-light doc なので、キャンペーンは per-unit オーバーヘッドなしで数百万にスケールします。

# Next