공유 및 검증

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 — 페이지 내 모달을 열어 한 명 또는 여러 수신자에게 스타일이 적용된 이메일을 전송합니다 (아래 이메일 공유 참조)
• Copy Link — 검증 URL을 클립보드에 복사합니다
• Embed snippets — 배지를 웹사이트, 인트라넷 또는 이메일 서명에 삽입할 수 있도록 바로 붙여넣을 수 있는 <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 에지에서 캐시되므로, 첫 번째 공유에서도 미리보기가 즉시 표시됩니다.

이메일 공유

배지 수여를 이메일로 전송하는 두 가지 방법이 있습니다.

공개 공유 페이지에서

수령자는 공유 페이지에서 Send Email을 클릭하여 친구, 멘토 또는 잠재적 고용주와 배지를 공유할 수 있습니다. 하나 이상의 이메일 주소, 선택적 제목 및 개인 메시지를 입력하는 모달이 열립니다.

각 수신자는 수령자의 개인 메시지와 공개 수여 페이지를 보기 위한 원클릭 버튼이 포함된 스타일링된 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 assertion의 일부이기 때문에, 나중에 배지 아트워크를 교체해도 이전에 발행된 수여는 손상되지 않습니다. 기존 IPFS CID는 영원히 해석 가능한 상태로 유지되므로, 새로운 발행을 위해 배지를 재설계하더라도 과거의 수여는 원래 이미지를 그대로 유지합니다.