Integracije (Zapier, Make in več)

Povežite badges.ninja z orodji, ki jih že uporabljate — samodejno izdajajte poverilnice, ko se drugje kaj zgodi, in se v realnem času odzovite, ko so poverilnice izdane, dostavljene, preklicane ali ogledane. Deluje vsaka platforma, ki govori REST in webhooke; Zapier in Make sta najhitrejša.

Kaj lahko avtomatizirate

Sprožilci (badges.ninja → vaša orodja) — sprožite potek dela, ko:

• je poverilnica izdana
• je poverilnica dostavljena (njeno e-poštno sporočilo je poslano)
• je poverilnica preklicana
• je poverilnica prvič ogledana

Dejanja (vaša orodja → badges.ninja):

• izdaj poverilnico — podeli značko prejemniku

Predpogoji

1. Ustvarite API ključ v nadzorni plošči pod API ključi. Za dejanja (izdajanje) uporabite ključ za branje in pisanje; za sprožilce zadošča ključ samo za branje. Glejte API ključi.
2. To je vse — vse teče prek REST API in webhookov.

Zapier

Ko je aplikacija badges.ninja za Zapier povezana:

1. Povežite svoj račun — ob pozivu prilepite svoj API ključ.
2. Izberite sprožilec (npr. Credential Issued) ali dejanje Issue Credential.
3. Preslikajte polja in vklopite Zap.

V ozadju sprožilci uporabljajo model REST Hook platforme Zapier, podprt z Webhooks API: Zapier se naroči prek POST /webhooks, badges.ninja pa mu dogodke dostavlja v realnem času, tako da ni zakasnitve zaradi poizvedovanja.

Make (Integromat) in platforme po meri

Aplikacija ni potrebna — povežite neposredno:

1. Avtenticirajte se z glavo X-Api-Key pri vsaki zahtevi.
2. Naročite se na dogodke z registracijo svoje končne točke:

   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. Prejemajte podpisane dostave na svoji končni točki. Preverite glavo X-Bws-Signature — glejte Webhooks.
4. Izdajajte poverilnice s klicem POST /awards — glejte Awards API.

Reference

• Webhooks API — dogodki, vsebine, podpisi, ponovni poskusi
• Awards API — izdajanje poverilnic
• API ključi — ključi in obsegi dostopa

Izvorna koda aplikacije Zapier je v repozitoriju pod integrations/zapier/ in jo je mogoče objaviti z Zapier CLI.