MostlyQR

シリアライズされたコード

物理的なユニットごとに独自の一意なコードを付与します — 製品ラインごとに1つのコードではなく、アイテムごとに個別の列挙不可能なシリアルを使用します。これにより、ユニットごとの分析、リコール、および偽造品対策の検証が可能になります。Enterpriseプランです。

モデルには3つのティアがあります：

  • Campaign — 製品/SKU：宛先＋ブランド＋ステータス。ダッシュボード（Serialized タブ）またはダッシュボード API を通じて作成されます。
  • Batch — キャンペーン下の生産ロット（ミント時に作成）。
  • Unit — 1つの物理アイテム、そのシリアル（mqr.sh/u/<serial>）で識別されます。

# バッチをミントする

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

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" }

# ミントジョブをポーリングする

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 }

# 印刷対応バンドルをエクスポートする

ミント後、マニフェスト（CSV＋各シリアルとそのURLのオプションの 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 }

# 記号体系と製品パスポート

各シリアルは QR、ECC200 DataMatrix（タイトなパッケージング）、または GTIN ＋ バッチ ＋ 有効期限 ＋ シリアルを搭載した GS1 Digital Link としてレンダリングできます。また、ユニットが検証されたときに表示されるデジタル製品パスポート（Model、Release year、Material…）を添付することもできます。

# 偽造品対策

ユニットごとのスキャンはクローン検出ヒューリスティック（同じシリアルが分散された地域に表示される、または不可能な移動）を実行し、フラグ遷移時に clone.suspected ウェブフックを起動します。判定はVerificationを通じて公に表示されます。

# 注記

  • ミントは Enterprise プランの serialized_codes 割り当てに制限されています — 非 Enterprise キーは 403 を取得します。
  • ユニットは超軽量ドキュメントなので、キャンペーンは数百万までスケーリングでき、ユニットごとのオーバーヘッドはありません。

# 次へ