Tích hợp (Zapier, Make & hơn thế nữa)

Kết nối badges.ninja với các công cụ bạn đã dùng — tự động cấp chứng chỉ khi có việc gì đó xảy ra ở nơi khác, và phản ứng theo thời gian thực khi chứng chỉ được cấp, gửi đi, thu hồi hoặc được xem. Bất kỳ nền tảng nào nói được REST và webhooks đều dùng được; Zapier và Make là nhanh nhất.

Bạn có thể tự động hóa những gì

Triggers (badges.ninja → công cụ của bạn) — kích hoạt một quy trình khi:

một chứng chỉ được cấp
một chứng chỉ được gửi đi (email của nó được gửi)
một chứng chỉ bị thu hồi
một chứng chỉ được xem lần đầu tiên

Actions (công cụ của bạn → badges.ninja):

cấp một chứng chỉ — trao một huy hiệu cho người nhận

Điều kiện tiên quyết

Tạo một khóa API trong bảng điều khiển tại mục API Keys. Dùng khóa đọc-ghi cho các hành động (cấp phát); khóa chỉ-đọc là đủ cho triggers mà thôi. Xem Khóa API.
Vậy là xong — mọi thứ đều chạy qua REST API và webhooks.

Zapier

Sau khi ứng dụng Zapier của badges.ninja được kết nối:

Kết nối tài khoản của bạn — dán khóa API khi được nhắc.
Chọn một trigger (ví dụ Credential Issued) hoặc hành động Issue Credential.
Ánh xạ các trường và bật Zap lên.

Bên trong, các trigger dùng mô hình REST Hook của Zapier dựa trên Webhooks API: Zapier đăng ký qua POST /webhooks và badges.ninja gửi các sự kiện tới nó theo thời gian thực, nên không có độ trễ do phải liên tục truy vấn.

Make (Integromat) & các nền tảng tùy chỉnh

Không cần ứng dụng — hãy đấu nối trực tiếp:

Xác thực bằng header X-Api-Key trên mỗi yêu cầu.

Đăng ký nhận sự kiện bằng cách đăng ký điểm cuối của bạn:

bash

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"] }'

Nhận các lần gửi đã ký tại điểm cuối của bạn. Xác minh header X-Bws-Signature — xem Webhooks.
Cấp chứng chỉ bằng cách gọi POST /awards — xem Awards API.

Tham khảo

Webhooks API — sự kiện, payload, chữ ký, thử lại
Awards API — cấp chứng chỉ
Khóa API — khóa và phạm vi truy cập

Mã nguồn của ứng dụng Zapier nằm trong kho lưu trữ tại integrations/zapier/ và có thể được đẩy lên bằng Zapier CLI.

Tích hợp (Zapier, Make & hơn thế nữa) ​

Bạn có thể tự động hóa những gì ​

Điều kiện tiên quyết ​

Zapier ​