Integrácie (Zapier, Make a ďalšie)

Prepojte badges.ninja s nástrojmi, ktoré už používate — vydávajte poverovacie listiny automaticky, keď sa niekde inde niečo stane, a reagujte v reálnom čase, keď sú poverovacie listiny vydané, doručené, odvolané alebo zobrazené. Funguje akákoľvek platforma, ktorá ovláda REST a webhooky; Zapier a Make sú najrýchlejšie.

Čo môžete automatizovať

Spúšťače (badges.ninja → vaše nástroje) — spustite pracovný postup, keď:

• je poverovacia listina vydaná
• je poverovacia listina doručená (je odoslaný jej e-mail)
• je poverovacia listina odvolaná
• je poverovacia listina zobrazená prvýkrát

Akcie (vaše nástroje → badges.ninja):

• vydajte poverovaciu listinu — udeľte odznak príjemcovi

Predpoklady

1. Vytvorte API kľúč v paneli v časti API Keys. Použite read-write kľúč pre akcie (vydávanie); pre samotné spúšťače postačuje read-only kľúč. Pozri API kľúče.
2. To je všetko — všetko beží cez REST API a webhooky.

Zapier

Keď je aplikácia badges.ninja Zapier pripojená:

1. Pripojte svoj účet — po výzve vložte svoj API kľúč.
2. Vyberte spúšťač (napr. Credential Issued) alebo akciu Issue Credential.
3. Namapujte polia a zapnite Zap.

Pod kapotou spúšťače používajú model REST Hook od Zapier podložený Webhooks API: Zapier sa prihlási cez POST /webhooks a badges.ninja mu doručuje udalosti v reálnom čase, takže nedochádza k oneskoreniu z dopytovania.

Make (Integromat) a vlastné platformy

Nie je potrebná žiadna aplikácia — prepojte to priamo:

1. Autentifikujte sa hlavičkou X-Api-Key pri každej požiadavke.
2. Prihláste sa na odber udalostí zaregistrovaním svojho koncového bodu:

   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. Prijímajte podpísané doručenia na svojom koncovom bode. Overte hlavičku X-Bws-Signature — pozri Webhooks.
4. Vydávajte poverovacie listiny volaním POST /awards — pozri Awards API.

Referencie

• Webhooks API — udalosti, payloady, podpisy, opakovania
• Awards API — vydávanie poverovacích listín
• API kľúče — kľúče a prístupové rozsahy

Zdrojový kód aplikácie Zapier sa nachádza v repozitári v priečinku integrations/zapier/ a dá sa nahrať pomocou Zapier CLI.