検証
誰でも(買い手やリセラー)は、シリアル化されたユニットが本物であるかどうかを確認できます。検証は公開されています。印刷されたシリアルが認証情報であるため、APIキーは必要ありません。ユニットの実際のスキャン履歴とクローン検出結果を読み取ります。
# 検証ページ
ユニットのコード(またはそのGS1デジタルリンク)をポイントしてください:
https://mostlyqr.com/Verify?s=<serial>
任意のスマートフォンカメラでスキャンする(アプリ不要)と、本物/フラグ付き/見つかりませんという結果、製品、バッチ、および任意のパスポート属性が表示されます。ページは、組み込みカメラスキャナーでQR、DataMatrix、Code 128/EAN-13も読み取ることができます。
# プログラマティック検証(呼び出し可能)
検証サーフェスは、公開Firebase呼び出し可能(ベアラーキーRESTルートではない)なので、キーなしでブラウザから呼び出すことができます:
curl -X POST https://europe-west2-mostly-qr.cloudfunctions.net/verifyUnitCode \
-H "Content-Type: application/json" \
-d '{ "data": { "serial": "K0TKPSGN9AB" } }'
{ "result": {
"serial": "K0TKPSGN9AB",
"status": "genuine",
"reason": "ok",
"public": { "product": "Spring Roast 250g", "batch": "L-2027-04",
"attributes": [ { "label": "Model", "value": "Single-origin Ethiopia" } ] } } }
statusは以下のいずれかです:
| ステータス | 意味 |
|---|---|
genuine |
ミント済み、アクティブ、フラグなし。 |
flagged |
クローンヒューリスティックがトリップ、またはユニット/キャンペーンが取り消された。reason/detailで説明。 |
unknown |
発行したシリアルではない(ミントされていない、またはタイプミス)—注意して扱う。 |
publicペイロードはプライバシー安全な投影です:製品、バッチ、粗い地域、スキャン数、およびブランド属性のみ—アカウント、宛先、または生のスキャンログは含まれません。
# リセラー一括検証
ディストリビューターは、検証ページ(「多くを検証」)または一括呼び出し可能(最大200シリアル、重複排除;エントリは単純なシリアル、検証URL、またはデジタルリンク)で在庫リスト全体を一度にチェックできます:
curl -X POST https://europe-west2-mostly-qr.cloudfunctions.net/verifyUnitsBulkCode \
-H "Content-Type: application/json" \
-d '{ "data": { "serials": ["K0TKPSGN9AB", "https://mostlyqr.com/Verify?s=ABCDEFGHJK7"] } }'
シリアルごとの判定配列と数を返す—パレットを受け取る前に重複または未発行の在庫をスポットします。ページは結果のCSVエクスポートを提供します。
# デジタル製品パスポート
ブランドは、キャンペーン(またはバッチごと)に属性を添付できます—モデル、リリース年、素材、起源…—検証結果にレンダリングされ、真正性をプロベナンスページに変えます(GS1デジタルリンク/EUダッパ方向に合致)。ダッシュボードのシリアル化されたタブまたはキャンペーンAPI経由で設定します。バッチ属性はラベルによってキャンペーン属性をオーバーライドします。
# 真正性証明書
本物の結果は、ダウンロード可能な証明書(ブラウザで生成されたブランド画像)を提供します。サーバー側/一括PDF版(MostlyRender経由)はロードマップにあります。
# 次へ
- シリアル化されたコード—チェックするユニットをミントする方法。
- 完全なAPIリファレンス。