検証
ショッパーや再販業者を問わず、誰でもシリアル化されたユニットが本物かどうかを確認できます。検証は公開です。印刷されたシリアルそのものが認証情報なので、APIキーは必要ありません。ユニットの実際のスキャン履歴とクローン検出結果を読み取ります。
# 検証ページ
ユニットのコード(またはそのGS1デジタルリンク)を次のURLに指定します。
https://mostlyqr.com/Verify?s=<serial>
任意の携帯電話カメラ(アプリ不要)でスキャンすると、本物 / フラグ付き / 見つかりませんという結果、製品、バッチ、およびパスポート属性が表示されます。このページには、QR、DataMatrix、Code 128 / EAN-13を読み取れる内蔵カメラスキャナーも備わっています。
# プログラム的なチェック(呼び出し可能)
検証サーフェスはパブリック Firebase の呼び出し可能な関数です(Bearer キーの 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",
"region": "GB", "scan_count": 3,
"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 DPP 方向に合致)。ダッシュボードの「シリアル化」タブまたはキャンペーンAPIで設定できます。バッチ属性はラベル別にキャンペーン属性をオーバーライドします。
# 真正性証明書
本物の結果は、ダウンロード可能な証明書(ブラウザで生成されたブランド画像)を提供します。サーバー側/一括PDF版(MostlyRenderを使用)はロードマップに含まれています。