共有と検証

badges.ninja のすべての授与には、サインインなしで誰でもアクセスできる公開検証ページが用意されています。受領者はソーシャルメディア、メール、または直接リンクのコピーによってバッジを共有できます。

受領者にも専用のポータルがあります

badges.ninja でバッジを獲得した場合、badges.ninja/me にサインイン（パスワード不要）することで、すべてのバッジを一か所で確認したり、badges.ninja/u/<your-handle> で公開プロフィールを整備したりできます。受領者ポータルを参照してください。

公開授与ページ

各授与には公開 URL があります。

https://badges.ninja/awards/{guid}

このページには、バッジ画像（IPFS から読み込み）、バッジ名と説明、受領者名、発行者名とロゴ、発行日と有効期限（ある場合）、そして受領者がバッジを獲得するために満たした基準が表示されます。リンクを持っている人なら誰でもページを開いて、その資格情報が本物であることを確認できます。

発行者が LinkedIn の組織 ID を設定している場合、Add to LinkedIn profile ボタンが表示され、受領者は資格情報を LinkedIn のライセンスと資格に直接保存できます。Download Badge ボタンは元のバッジ画像（IPFS から直接）を提供し、Download PDF はその場で印刷可能な A4 証明書を生成します。

公開共有ページ

共有ページにはソーシャル共有のオプションが用意されています。

https://badges.ninja/awards/{guid}/share

このページから、受領者は次の場所でバッジを共有できます。

• LinkedIn — LinkedIn フィードに投稿するか、Add to LinkedIn Profile ボタンを使用して資格情報を直接プロフィールに追加します（発行者が LinkedIn の組織 ID を設定している場合）
• Twitter / X — バッジリンクとカスタム共有テキスト付きのツイートを投稿します
• Facebook — Facebook のタイムラインに共有します
• WhatsApp — バッジリンク付きのメッセージを送信します
• Telegram — バッジリンク付きのメッセージを送信します
• Send Email — ページ内モーダルを開き、1 人または複数の受信者にスタイル付きメールを送信します（下記のメール共有を参照）
• Copy Link — 検証 URL をクリップボードにコピーします
• Embed snippets — Web サイト、イントラネット、メール署名にバッジを差し込むための、貼り付け可能な <img> および <iframe> HTML をコピーします

QR 検証

専用の検証ページには、自身の URL を指すスキャン可能な QR コードが表示されます — 印刷された証明書、イベントバナー、LinkedIn のスクリーンショットに最適です。

https://badges.ninja/verify/{guid}

携帯電話のカメラで QR をスキャンすると、ライブの検証ページに移動し、バッジが badges.ninja でホストされていること、Open Badge v2.0 仕様に準拠していること、そして（Pro プランでは）Matchain を介してオンチェーンにアンカーされていることを確認できます。受領者の身元は SHA-256 ハッシュとして表示されるため、メールアドレスが公に公開されることは決してありません。

PDF 証明書

すべての授与には、公開検証ページに Download Certificate ボタンがあります。それをクリックすると、バッジ画像、受領者名、発行者、基準、発行日、オプションの有効期限、そしてライブ検証 URL にリンクする QR コードを含む、印刷可能な A4 PDF がその場で生成されます。

ソーシャルメディアプレビュー

バッジリンクが LinkedIn、X、Slack、Facebook、WhatsApp、メールで共有されると、プラットフォームは共有エンドポイントを取得し、badges.ninja が出力する Open Graph メタデータからリッチカードをレンダリングします。

• プレビュー画像としてバッジ画像
• タイトルとしてバッジ名
• 説明に発行者名と受領者名

これにより、どこで共有してもバッジがプロフェッショナルに見えるようになります — 受領者は自分の画像を添付したり、文章を書いたりする必要はありません。プレビューはサーバー側で /certify-badge/award/{guid}/share-html で生成され、CDN エッジでキャッシュされるため、最初の共有でもプレビューは即座に表示されます。

メール共有

バッジ授与をメールで送信するには 2 つの方法があります。

公開共有ページから

受領者は、共有ページの Send Email をクリックして、友人、メンター、または潜在的な雇用主とバッジを共有できます。1 つまたは複数のメールアドレス、オプションの件名、個人的なメッセージを入力するモーダルが開きます。

各宛先は、受領者の個人的なメッセージと、公開授与ページを表示するためのワンクリックボタンを含む、スタイル付きの HTML メールを受け取ります。

ダッシュボードから

発行者は、ダッシュボードの Awards ページから任意の授与をメールで送信できます。

1. Awards ページで授与を見つけます。
2. 行の Send ボタンをクリックするか、詳細モーダルを開いて Resend email をクリックします。
3. 受領者のメールアドレスを入力して送信します。

両方のフローで同じメールテンプレートが使用されます。

Open Badge v2.0 JSON エンドポイント

他のバッジプラットフォームとの相互運用性のため、badges.ninja は次の公開エンドポイントで標準の Open Badge v2.0 JSON を提供します。

エンドポイント	説明
/certify-badge/issuer/{guid}	発行者プロフィール JSON
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON（授与）

これらのエンドポイントは Open Badge v2.0 仕様に準拠した JSON-LD を返します。他のバッジプラットフォームや検証ツールはこのデータを利用して資格情報を検証できます。

例 — 授与を検証する：

curl https://api.badges.ninja/certify-badge/award/abc123-def456

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "Assertion",
  "id": "https://api.badges.ninja/certify-badge/award/abc123-def456",
  "recipient": {
    "type": "email",
    "identity": "sha256$..."
  },
  "badge": "https://api.badges.ninja/certify-badge/badge/xyz789",
  "issuedOn": "2025-01-15T00:00:00.000Z",
  "verification": {
    "type": "hosted"
  }
}

IPFS 画像 URL

バッジ画像は、当社独自のゲートウェイ ipfs.ninja を介して IPFS（InterPlanetary File System）にピン留めされています。これにより：

• 画像は永続的でコンテンツアドレッシングされており、改ざんしたり、こっそり置き換えたりすることはできません
• Open Badge JSON 内の画像 URL は https://ipfs.ninja/ipfs/{cid} のようになります
• 同じ content-ID は、任意の公開 IPFS ゲートウェイ（cloudflare-ipfs.com、ipfs.io など）を通じて解決できます — バッジは単一のプロバイダーに縛られません

画像は Open Badge アサーションの一部であるため、後でバッジのアートワークを置き換えても、以前に発行された授与は壊れません。古い IPFS CID は永久に解決可能なままなので、新しい発行のためにバッジを再設計しても、過去の授与は元の画像を保持し続けます。