Integrasi (Zapier, Make & lain-lain)

Sambungkan badges.ninja kepada alat yang telah anda gunakan — keluarkan kredensial secara automatik apabila sesuatu berlaku di tempat lain, dan bertindak balas secara masa nyata apabila kredensial dikeluarkan, dihantar, dibatalkan atau dilihat. Mana-mana platform yang bertutur REST dan webhooks berfungsi; Zapier dan Make adalah yang terpantas.

Apa Yang Boleh Anda Automasikan

Pencetus (badges.ninja → alat anda) — mencetuskan aliran kerja apabila:

• satu kredensial dikeluarkan
• satu kredensial dihantar (e-melnya dihantar)
• satu kredensial dibatalkan
• satu kredensial dilihat buat kali pertama

Tindakan (alat anda → badges.ninja):

• keluarkan kredensial — anugerahkan lencana kepada penerima

Prasyarat

1. Cipta kunci API dalam papan pemuka di bawah API Keys. Gunakan kunci baca-tulis untuk tindakan (mengeluarkan); kunci baca sahaja memadai untuk pencetus sahaja. Lihat Kunci API.
2. Itu sahaja — semuanya berjalan melalui REST API dan webhooks.

Zapier

Setelah aplikasi Zapier badges.ninja disambungkan:

1. Sambungkan akaun anda — tampal kunci API anda apabila digesa.
2. Pilih pencetus (cth. Credential Issued) atau tindakan Issue Credential.
3. Petakan medan dan hidupkan Zap.

Di sebalik tabir, pencetus menggunakan model REST Hook Zapier yang disokong oleh Webhooks API: Zapier melanggan melalui POST /webhooks dan badges.ninja menghantar peristiwa kepadanya secara masa nyata, jadi tiada kelewatan tinjauan.

Make (Integromat) & Platform Tersuai

Tiada aplikasi diperlukan — wayarkan terus:

1. Sahkan dengan pengepala X-Api-Key pada setiap permintaan.
2. Langgani peristiwa dengan mendaftarkan titik akhir 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 penghantaran yang ditandatangani di titik akhir anda. Sahkan pengepala X-Bws-Signature — lihat Webhooks.
4. Keluarkan kredensial dengan memanggil POST /awards — lihat Awards API.

Rujukan

• Webhooks API — peristiwa, muatan, tandatangan, cubaan semula
• Awards API — mengeluarkan kredensial
• Kunci API — kunci dan skop akses

Sumber aplikasi Zapier terletak dalam repositori di bawah integrations/zapier/ dan boleh ditolak dengan Zapier CLI.