FAQ

badges.ninja에 대해 자주 묻는 질문이에요.

디지털 배지란 무엇인가요?

디지털 배지는 기술, 성취 또는 자격 증명을 시각적으로 보여 주고 검증할 수 있게 만든 표현이에요. 각 배지에는 무엇을 달성했는지, 누가 달성했는지, 누가 발급했는지, 필요한 기준이 무엇인지에 대한 메타데이터가 담겨 있어요. 종이 인증서와 달리 디지털 배지는 배지 URL만 있으면 누구나 온라인에서 검증할 수 있어요.

badges.ninja는 어떤 Open Badge 표준을 지원하나요?

모든 자격 증명은 Open Badges 2.0 호스팅 어서션으로 발급돼요. 이는 IMS Global(현 1EdTech)의 업계 표준으로, 세 가지 핵심 데이터 객체인 Issuer(발급 주체), BadgeClass(발급되는 내용), Assertion(특정 개인에게 발급된 자격 증명)을 정의해요. 또한 모든 자격 증명은 Open Badges 3.0 / W3C Verifiable Credential(우리의 did:web 발급자 키로 서명된 VC-JWT)로 내보내서 검증 가능한 자격 증명 지갑으로 가져올 수 있어요. 두 가지를 모두 지원하므로 LinkedIn과 Credly를 포함한 다른 Open Badge 플랫폼 및 검증 도구와 배지가 상호 운용돼요.

배지 이미지는 어떻게 저장되나요?

배지 이미지는 Amazon S3에 호스팅되며, 콘텐츠 주소 기반의 변경 불가능한 URL(이미지의 암호화 해시에서 파생)로 글로벌 CDN을 통해 제공돼요. 빠르게 로드되고 자격 증명이 유지되는 동안 계속 사용할 수 있어요.

무료 요금제에는 무엇이 포함되나요?

Free 요금제에는 발급자 2개, 배지 클래스 5개, 연간 자격 증명 1,200개, API 키 1개가 포함되고, 비주얼 배지 디자이너, 영구 이미지 호스팅, Open Badges 2.0 & 3.0 준수까지 전체 제품을 신용카드 없이 무료로 이용할 수 있어요. 자격 증명 허용량은 계정 가입 기념일에 초기화되는 유연한 연간 풀이에요.

API로 배지 생성을 자동화할 수 있나요?

네. badges.ninja는 발급자, 배지, 자격 증명을 프로그래밍 방식으로 만들 수 있는 전체 REST API를 제공해요. 대시보드에서 API 키를 생성하고 X-Api-Key 헤더에 포함하세요. 예제가 포함된 전체 문서는 API 레퍼런스를 참고하세요.

배지를 발급한 후에 취소할 수 있나요?

네. 자격 증명 페이지에서 개별 자격 증명을 취소하거나(선택적으로 사유를 입력하고 수령자에게 알림), 여러 개를 한꺼번에 취소하거나, 완전히 삭제할 수 있어요. 취소된 자격 증명도 계속 조회할 수 있지만, 공개 검증 페이지에는 해당 자격 증명이 취소되었다고 표시돼요. 취소 상태는 Open Badges 2.0 호스팅 어서션 및 Open Badges 3.0 Verifiable Credential(W3C Bitstring Status List 사용)에 모두 반영되므로 VC 지갑에서도 확인할 수 있어요.

수령자는 배지를 어디에서 모으나요?

수령자는 badges.ninja/me에서 비밀번호 없이 로그인해 발급받은 모든 배지를 볼 수 있고, badges.ninja/u/<handle>에 공개 프로필을 만들어 자격 증명을 선보일 수 있어요. 각 자격 증명에는 자체 공개 검증 및 공유 페이지도 있어요.

대량 자격 증명은 어떻게 작동하나요?

대량 자격 증명을 사용하면 이름과 이메일이 담긴 CSV 파일을 업로드해 같은 배지를 수백, 수천 명의 수령자에게 발급할 수 있어요. 시스템이 각 행을 처리하며 실시간 진행 상황을 보여 주고, 일시 중지, 재개, 취소를 할 수 있어요. 처리가 끝나면 성공한 자격 증명과 실패한 자격 증명의 CSV를 각각 다운로드할 수 있어요. 전체 가이드는 대량 자격 증명을 참고하세요.

수령자는 배지를 어떻게 공유하나요?

각 자격 증명에는 공개 검증 페이지와 공유 페이지가 있어요. 수령자는 LinkedIn, Twitter/X, Facebook, WhatsApp, Telegram 또는 이메일로 배지를 공유할 수 있고, 직접 검증 URL을 복사할 수도 있어요. 소셜 미디어 공유에는 배지 이미지와 설명이 담긴 리치 미리보기가 포함돼요. 공유 및 검증을 참고하세요.

내 데이터는 어떻게 보호되나요?

badges.ninja는 저장 시와 전송 시 암호화를 적용한 AWS 인프라를 사용해요. 인증은 안전한 비밀번호 정책을 갖춘 Amazon Cognito가 처리해요. API 키는 암호학적 방식으로 생성돼요. 배지 이미지는 콘텐츠 주소 기반(변경 불가능한 해시 기반 URL)이며 CDN에서 HTTPS로 제공돼요. 플랫폼은 WAF 보호와 DDoS 완화를 포함한 보안 모범 사례를 따라요.

지원은 어떻게 받나요?

도움이 필요하면 대시보드 사이드바에서 지원 페이지를 여세요. 문제를 설명하는 지원 티켓을 만들면 팀이 답변해 드려요. 자주 묻는 질문은 이 문서와 빠른 시작 가이드에서도 확인할 수 있어요.