통합(Zapier, Make 등)

이미 사용 중인 도구에 badges.ninja를 연결하세요——다른 곳에서 어떤 일이 일어나면 자동으로 크리덴셜을 발급하고, 크리덴셜이 발급, 전달, 취소, 조회될 때 실시간으로 반응할 수 있습니다. REST와 웹훅을 지원하는 플랫폼이면 무엇이든 작동하며, Zapier와 Make가 가장 빠릅니다.

자동화할 수 있는 것

트리거(badges.ninja → 당신의 도구)——다음의 경우 워크플로를 실행합니다:

• 크리덴셜이 발급됨
• 크리덴셜이 전달됨(이메일이 전송됨)
• 크리덴셜이 취소됨
• 크리덴셜이 처음으로 조회됨

액션(당신의 도구 → badges.ninja):

• 크리덴셜 발급——수신자에게 배지를 수여합니다

사전 준비

1. 대시보드의 API 키에서 API 키를 생성합니다. 액션(발급)에는 읽기-쓰기 키를 사용하고, 트리거만 필요하면 읽기 전용 키로 충분합니다. API 키를 참조하세요.
2. 이게 전부입니다——모든 것이 REST API와 웹훅 위에서 동작합니다.

Zapier

badges.ninja Zapier 앱이 연결되면:

1. 계정 연결——프롬프트가 표시되면 API 키를 붙여넣습니다.
2. 트리거 선택(예: Credential Issued) 또는 Issue Credential 액션을 선택합니다.
3. 필드를 매핑하고 Zap을 켭니다.

내부적으로 트리거는 Webhooks API에 기반한 Zapier의 REST Hook 모델을 사용합니다: Zapier가 POST /webhooks로 구독하고 badges.ninja가 실시간으로 이벤트를 전달하므로 폴링 지연이 없습니다.

Make(Integromat) 및 사용자 지정 플랫폼

앱이 필요 없습니다——직접 연결하세요:

1. 모든 요청에 X-Api-Key 헤더로 인증합니다.
2. 엔드포인트를 등록하여 이벤트를 구독합니다:

   curl -X POST https://api.badges.ninja/webhooks \
     -H "X-Api-Key: bws_your_api_key_here" \
     -H "Content-Type: application/json" \
     -d '{ "url": "https://hook.example.com/badges", "events": ["credential.issued"] }'

3. 당신의 엔드포인트에서 서명된 전달을 수신합니다. X-Bws-Signature 헤더를 검증하세요——Webhooks를 참조하세요.
4. POST /awards를 호출하여 크리덴셜을 발급합니다——Awards API를 참조하세요.

참조

• Webhooks API — 이벤트, 페이로드, 서명, 재시도
• Awards API — 크리덴셜 발급
• API 키 — 키와 액세스 범위

Zapier 앱 소스는 리포지토리의 integrations/zapier/ 아래에 있으며 Zapier CLI로 푸시할 수 있습니다.