공유 및 검증

badges.ninja의 모든 자격 증명에는 로그인하지 않아도 누구나 접근할 수 있는 공개 검증 페이지가 있어요. 수령자는 소셜 미디어, 이메일, 또는 직접 링크 복사로 배지를 공유할 수 있어요.

수령자를 위한 전용 포털도 있어요

badges.ninja를 통해 배지를 받았다면 **badges.ninja/me**에서 (비밀번호 없이) 로그인해 모든 배지를 한곳에서 확인하고, badges.ninja/u/<your-handle>에서 공개 프로필을 꾸밀 수 있어요. 수령자 포털을 참고하세요.

공개 자격 증명 페이지

각 자격 증명에는 공개 URL이 있어요.

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

이 페이지에는 배지 이미지, 배지 이름과 설명, 수령자 이름, 발급자 이름과 로고, 발급일과 만료일(있는 경우), 그리고 수령자가 배지를 받기 위해 충족한 기준이 표시돼요. 링크가 있는 사람은 누구나 이 페이지를 열어 자격 증명이 진본인지 확인할 수 있어요.

자격 증명 페이지에는 항상 LinkedIn 프로필에 추가 버튼이 표시되어, 수령자가 자격 증명을 LinkedIn의 면허 및 자격증 항목에 바로 저장할 수 있어요. (발급자가 LinkedIn 조직 ID를 설정했다면 LinkedIn이 인증된 회사 페이지를 미리 채워 주고, 그렇지 않으면 발급자 이름으로 대체돼요.) 다운로드 드롭다운 하나에서 두 가지 옵션을 제공해요. 배지 이미지(원본 PNG)와 인증서(/certify-badge/award/{guid}/pdf에서 즉석으로 생성되는 인쇄용 A4 PDF)예요.

공개 공유 페이지

공유 페이지는 소셜 공유 옵션을 제공해요.

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

이 페이지에서 수령자는 다음 방법으로 배지를 공유할 수 있어요.

• LinkedIn — 배지를 LinkedIn 피드에 게시해요 (프로필에 자격 증명을 직접 추가하려면 자격 증명 페이지의 LinkedIn 프로필에 추가 버튼을 사용하세요)
• Twitter / X — 배지 링크와 맞춤 공유 문구가 담긴 트윗을 게시해요
• Facebook — Facebook 타임라인에 공유해요
• WhatsApp — 배지 링크가 담긴 메시지를 보내요
• Telegram — 배지 링크가 담긴 메시지를 보내요
• 이메일 보내기 — 한 명 이상에게 스타일이 적용된 이메일을 보내는 페이지 내 모달을 열어요 (아래 이메일 공유 참고)
• 링크 복사 — 검증 URL을 클립보드에 복사해요
• 임베드 스니펫 — 웹사이트, 인트라넷, 이메일 서명에 배지를 넣을 수 있도록 바로 붙여 넣을 수 있는 <img> 및 <iframe> HTML을 복사해요

QR 검증

전용 검증 페이지는 자체 URL을 가리키는 스캔 가능한 QR 코드를 보여 줘요. 인쇄된 인증서, 행사 배너, LinkedIn 스크린샷에 안성맞춤이에요.

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

휴대폰 카메라로 QR을 스캔하면 실시간 검증 페이지로 이동하고, 여기서 배지가 badges.ninja에 호스팅되어 있고 Open Badge v2.0 사양을 따르는지 확인할 수 있어요. 수령자 신원은 SHA-256 해시로 표시되므로 이메일이 공개적으로 노출되지 않아요.

PDF 인증서

모든 자격 증명은 인쇄용 A4 PDF 인증서로 다운로드할 수 있어요. 인증서 옵션은 공개 자격 증명 페이지(/awards/{guid})의 다운로드 드롭다운에 있어요. 스캔 가능한 QR 코드와 원시 Open Badge JSON만 있는 검증 페이지에는 없어요. 이 옵션을 선택하면 배지 이미지, 수령자 이름, 발급자, 기준, 발급일, 선택적 만료일, 그리고 실시간 검증 URL로 연결되는 QR 코드가 담긴 PDF를 (/certify-badge/award/{guid}/pdf에서) 즉석으로 생성해요.

소셜 미디어 미리보기

배지 링크를 LinkedIn, X, Slack, Facebook, WhatsApp 또는 이메일에서 공유하면, 해당 플랫폼이 공유 엔드포인트를 가져와 badges.ninja가 내보내는 Open Graph 메타데이터로 풍부한 카드를 렌더링해요.

• 배지 이미지가 미리보기 이미지로 쓰여요
• 배지 이름이 제목으로 쓰여요
• 발급자 이름과 수령자 이름이 설명에 들어가요

덕분에 어디에서 공유해도 배지가 전문적으로 보여요. 수령자가 직접 이미지를 첨부하거나 문구를 쓸 필요가 없어요. 미리보기는 /certify-badge/award/{guid}/share-html에서 서버 측으로 생성되어 CDN 엣지에 캐시되므로, 처음 공유할 때도 미리보기가 즉시 나타나요.

이메일 공유

자격 증명은 두 가지 방법으로 이메일로 보낼 수 있어요.

공개 공유 페이지에서

수령자는 공유 페이지에서 이메일 보내기를 클릭해 친구, 멘토, 또는 잠재적 고용주와 배지를 공유할 수 있어요. 모달이 열리면 하나 이상의 이메일 주소, 선택 사항인 제목, 개인 메시지를 입력해요.

각 수신자는 수령자의 개인 메시지와, 공개 자격 증명 페이지를 한 번에 볼 수 있는 버튼이 담긴 스타일이 적용된 HTML 이메일을 받아요.

대시보드에서

발급자는 대시보드의 자격 증명 페이지에서 어떤 자격 증명이든 이메일로 보낼 수 있어요.

1. 자격 증명 페이지에서 해당 자격 증명을 찾아요.
2. 행의 보내기 버튼을 클릭하거나, 상세 모달을 열어 이메일 다시 보내기를 클릭해요.
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"
  }
}

배지 이미지 URL

배지 이미지는 Amazon S3에 저장되고, 이미지 바이트의 암호화 해시(SHA-256)에서 파생된 콘텐츠 주소 기반의 불변 URL로 글로벌 CDN을 통해 제공돼요. 이는 다음을 의미해요.

• 이미지는 영구적이며 콘텐츠 주소 기반이에요 — URL이 바이트 자체에서 파생되므로 변조하거나 몰래 교체할 수 없어요
• Open Badge JSON의 이미지 URL은 https://badges.ninja/images/{sha256}.png 형태예요
• 이미지는 CDN 엣지에서 제공되므로 전 세계 어디서나 빠르게 로드되고, 자격 증명이 존재하는 동안 계속 이용할 수 있어요

이미지는 Open Badge assertion의 일부이므로, 나중에 배지 아트워크를 교체해도 이미 발급된 자격 증명은 깨지지 않아요. 원본 이미지는 자체 콘텐츠 주소 URL을 유지하므로, 이후 발급분을 위해 배지를 새로 디자인해도 기존 자격 증명은 원래 이미지를 그대로 유지해요.