Skip to content

共有と検証 ​

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

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

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

公開クレデンシャルページ ​

各クレデンシャルには公開 URL があります。

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

このページには、バッジ画像、バッジ名と説明、受領者名、発行者名とロゴ、発行日と有効期限(ある場合)、そして受領者がバッジを獲得するために満たした基準が表示されます。リンクを知っていれば誰でもこのページを開き、クレデンシャルが本物であることを確認できます。

Public credential page

クレデンシャルページには常に Add to LinkedIn profile ボタンが表示され、受領者はクレデンシャルを LinkedIn の「免許/資格」に直接保存できます。(発行者が LinkedIn の組織 ID を設定している場合は、LinkedIn が認証済みの会社ページを自動入力します。設定がない場合は発行者名が使われます。)Download ドロップダウンには 2 つのオプションがあります。Badge image(元の PNG)と Certificate(/certify-badge/award/{guid}/pdf でその都度生成される印刷用 A4 PDF)です。

公開共有ページ ​

共有ページでは、ソーシャル共有のオプションを利用できます。

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

Public share page with social buttons + embed snippets

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

  • LinkedIn — バッジを LinkedIn のフィードに投稿します(クレデンシャルをプロフィールに直接追加するには、代わりにクレデンシャルページの Add to LinkedIn profile ボタンを使用してください)
  • Twitter / X — バッジのリンクとカスタム共有テキストを付けてツイートを投稿します
  • Facebook — Facebook のタイムラインに共有します
  • WhatsApp — バッジのリンクを付けてメッセージを送信します
  • Telegram — バッジのリンクを付けてメッセージを送信します
  • Send Email — ページ内のモーダルを開き、1 人または複数の宛先にスタイル付きメールを送信します(下記のメール共有を参照)
  • Copy Link — 検証 URL をクリップボードにコピーします
  • Embed snippets — すぐに貼り付けられる <img> と <iframe> の HTML をコピーして、ウェブサイト、イントラネット、メール署名にバッジを埋め込めます

QR 検証 ​

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

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

QR verification page with badge identity and scannable QR code

スマートフォンのカメラで QR をスキャンすると、ライブの検証ページに移動します。そこで、バッジが badges.ninja でホストされ、Open Badge v2.0 仕様に準拠していることを確認できます。受領者の識別情報は SHA-256 ハッシュとして表示されるため、メールアドレスが公開されることはありません。

PDF 証明書 ​

すべてのクレデンシャルは、印刷に適した A4 の PDF 証明書としてダウンロードできます。Certificate オプションは、公開クレデンシャルページ(/awards/{guid})の Download ドロップダウンにあります。検証ページにはありません(検証ページにあるのはスキャン可能な QR コードと Open Badge の生 JSON のみです)。選択すると、バッジ画像、受領者名、発行者、基準、発行日、任意の有効期限、そしてライブの検証 URL にリンクする QR コードを含む PDF が、その都度(/certify-badge/award/{guid}/pdf で)生成されます。

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

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

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

How a shared badge link renders as a social-media preview card

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

メール共有 ​

クレデンシャルは 2 つの方法でメール送信できます。

公開共有ページから ​

受領者は、共有ページで Send Email をクリックして、友人、メンター、採用候補先とバッジを共有できます。モーダルが開き、1 つ以上のメールアドレス、任意の件名、個人的なメッセージを入力します。

In-page send email modal — recipients enter addresses, subject, and a personal note

各宛先には、受領者の個人的なメッセージと、公開クレデンシャルページをワンクリックで開くボタンを含む、スタイル付きの HTML メールが届きます。

The actual email each addressee receives

ダッシュボードから ​

発行者は、ダッシュボードの Credentials ページから任意のクレデンシャルをメールで送信できます。

  1. Credentials ページでクレデンシャルを見つけます。
  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 を返します。他のバッジプラットフォームや検証ツールは、このデータを利用してクレデンシャルを検証できます。

例 — クレデンシャルを検証する:

bash
curl https://api.badges.ninja/certify-badge/award/abc123-def456
json
{
  "@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"
  }
}

バッジ画像の URL ​

バッジ画像は Amazon S3 に保存され、画像バイト列の暗号化ハッシュ(SHA-256)から導出されるコンテンツアドレス指定の不変 URL のもと、グローバル CDN を通じて配信されます。これには次の意味があります。

  • 画像は永続的でコンテンツアドレス指定されています。URL は画像のバイト列そのものから導出されるため、改ざんされたり、気付かれないうちに差し替えられたりすることはありません
  • Open Badge JSON 内の画像 URL は https://badges.ninja/images/{sha256}.png の形式です
  • 画像は CDN のエッジから配信されるため、世界中どこでも高速に読み込まれ、クレデンシャルが有効な間は利用可能であり続けます

画像は Open Badge の assertion の一部であるため、後からバッジのアートワークを差し替えても、すでに発行済みのクレデンシャルは壊れません。元の画像は独自のコンテンツアドレス指定 URL を保持するため、新しい発行分のためにバッジを再デザインしても、過去のクレデンシャルは元の画像のままです。

badges.ninja Documentation