Integrations (Zapier, Make at iba pa)

Ikonekta ang badges.ninja sa mga tool na ginagamit na ninyo — mag-isyu ng mga credential nang awtomatiko kapag may nangyari sa ibang lugar, at tumugon sa real time kapag ang mga credential ay na-isyu, na-deliver, na-revoke, o na-view. Anumang platform na nagsasalita ng REST at webhooks ay gumagana; ang Zapier at Make ang pinakamabilis.

Ano ang Maaari Ninyong I-automate

Triggers (badges.ninja → inyong mga tool) — magpaandar ng workflow kapag:

• isang credential ay na-isyu
• isang credential ay na-deliver (naipadala ang email nito)
• isang credential ay na-revoke
• isang credential ay na-view sa unang beses

Actions (inyong mga tool → badges.ninja):

• mag-isyu ng credential — mag-award ng badge sa isang recipient

Mga Kinakailangan

1. Gumawa ng API key sa dashboard sa ilalim ng API Keys. Gumamit ng read-write key para sa mga action (pag-isyu); ang read-only key ay sapat na para sa mga trigger lamang. Tingnan ang Mga API Key.
2. Iyon lang — lahat ay tumatakbo sa REST API at webhooks.

Zapier

Kapag nakakonekta na ang badges.ninja Zapier app:

1. Ikonekta ang inyong account — i-paste ang inyong API key kapag hiningi.
2. Pumili ng trigger (hal. Credential Issued) o ang Issue Credential action.
3. I-map ang mga field at i-on ang Zap.

Sa ilalim, ang mga trigger ay gumagamit ng REST Hook model ng Zapier na naka-backup ng Webhooks API: nag-su-subscribe ang Zapier sa pamamagitan ng POST /webhooks at ipinapadala rito ng badges.ninja ang mga event sa real time, kaya walang polling delay.

Make (Integromat) at mga Custom na Platform

Walang app na kailangan — i-wire ito nang direkta:

1. Mag-authenticate gamit ang X-Api-Key header sa bawat request.
2. Mag-subscribe sa mga event sa pamamagitan ng pagrehistro ng inyong endpoint:

   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. Tumanggap ng mga naka-sign na delivery sa inyong endpoint. I-verify ang X-Bws-Signature header — tingnan ang Webhooks.
4. Mag-isyu ng mga credential sa pamamagitan ng pagtawag sa POST /awards — tingnan ang Awards API.

Reference

• Webhooks API — mga event, payload, signature, retry
• Awards API — pag-isyu ng mga credential
• Mga API Key — mga key at access scope

Ang source ng Zapier app ay nasa repository sa ilalim ng integrations/zapier/ at maaaring i-push gamit ang Zapier CLI.