Integrasi (Zapier, Make & lainnya)

Hubungkan badges.ninja dengan alat yang sudah Anda gunakan — terbitkan kredensial secara otomatis ketika sesuatu terjadi di tempat lain, dan bereaksi secara real time ketika kredensial diterbitkan, dikirimkan, dicabut, atau dilihat. Platform apa pun yang mendukung REST dan webhook dapat digunakan; Zapier dan Make adalah yang tercepat.

Apa yang Dapat Anda Otomatiskan

Trigger (badges.ninja → alat Anda) — jalankan alur kerja ketika:

• sebuah kredensial diterbitkan
• sebuah kredensial dikirimkan (emailnya terkirim)
• sebuah kredensial dicabut
• sebuah kredensial dilihat untuk pertama kalinya

Action (alat Anda → badges.ninja):

• terbitkan kredensial — berikan lencana kepada penerima

Prasyarat

1. Buat kunci API di dasbor pada Kunci API. Gunakan kunci baca-tulis untuk action (penerbitan); kunci hanya-baca cukup untuk trigger saja. Lihat Kunci API.
2. Selesai — semuanya berjalan melalui REST API dan webhook.

Zapier

Setelah aplikasi Zapier badges.ninja terhubung:

1. Hubungkan akun Anda — tempel kunci API Anda saat diminta.
2. Pilih trigger (mis. Credential Issued) atau action Issue Credential.
3. Petakan field dan aktifkan Zap.

Di balik layar, trigger menggunakan model REST Hook dari Zapier yang didukung oleh Webhooks API: Zapier berlangganan melalui POST /webhooks dan badges.ninja mengirimkan peristiwa kepadanya secara real time, sehingga tidak ada jeda polling.

Make (Integromat) & Platform Kustom

Tidak perlu aplikasi — sambungkan langsung:

1. Autentikasi dengan tajuk X-Api-Key pada setiap permintaan.
2. Berlangganan peristiwa dengan mendaftarkan endpoint Anda:

   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. Terima pengiriman bertanda tangan di endpoint Anda. Verifikasi tajuk X-Bws-Signature — lihat Webhooks.
4. Terbitkan kredensial dengan memanggil POST /awards — lihat Awards API.

Referensi

• Webhooks API — peristiwa, payload, tanda tangan, percobaan ulang
• Awards API — menerbitkan kredensial
• Kunci API — kunci dan cakupan akses

Kode sumber aplikasi Zapier berada di repositori pada integrations/zapier/ dan dapat di-push dengan Zapier CLI.