Integratsioonid (Zapier, Make ja muud)

Ühenda badges.ninja tööriistadega, mida sa juba kasutad — väljasta tunnistusi automaatselt, kui mujal midagi juhtub, ja reageeri reaalajas, kui tunnistusi väljastatakse, edastatakse, tühistatakse või vaadatakse. Töötab iga platvorm, mis kõneleb REST-i ja webhooke; Zapier ja Make on kiireimad.

Mida saad automatiseerida

Päästikud (badges.ninja → sinu tööriistad) — käivita töövoog, kui:

• tunnistus väljastatakse
• tunnistus edastatakse (selle e-kiri saadetakse)
• tunnistus tühistatakse
• tunnistust vaadatakse esimest korda

Toimingud (sinu tööriistad → badges.ninja):

• väljasta tunnistus — anna saajale märk

Eeltingimused

1. Loo töölaual jaotises API-võtmed API-võti. Kasuta toimingute (väljastamine) jaoks lugemis-kirjutamisõigusega võtit; ainult päästikute jaoks sobib lugemisõigusega võti. Vt API-võtmed.
2. Ja ongi kõik — kõik käib REST API ja webhookide kaudu.

Zapier

Kui badges.ninja Zapieri rakendus on ühendatud:

1. Ühenda oma konto — kleebi API-võti, kui seda küsitakse.
2. Vali päästik (nt Credential Issued) või toiming Issue Credential.
3. Kaardista väljad ja lülita Zap sisse.

Kapoti all kasutavad päästikud Zapieri REST Hook mudelit, mille aluseks on Webhookide API: Zapier tellib POST /webhooks kaudu ja badges.ninja edastab sündmused sellele reaalajas, seega pole pärimisviivet.

Make (Integromat) ja kohandatud platvormid

Rakendust pole vaja — ühenda otse:

1. Autendi iga päringu juures päisega X-Api-Key.
2. Telli sündmustele, registreerides oma lõpp-punkti:

   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. Võta vastu allkirjastatud edastused oma lõpp-punktis. Kontrolli päist X-Bws-Signature — vt Webhookid.
4. Väljasta tunnistusi, kutsudes POST /awards — vt Autasude API.

Viide

• Webhookide API — sündmused, andmesisu, allkirjad, kordused
• Autasude API — tunnistuste väljastamine
• API-võtmed — võtmed ja juurdepääsu ulatused

Zapieri rakenduse lähtekood asub repositooriumis kaustas integrations/zapier/ ja seda saab pushida Zapieri CLI-ga.