Integracije (Zapier, Make i više)

Povežite badges.ninja s alatima koje već koristite — izdajte vjerodajnice automatski kada se negdje drugdje nešto dogodi i reagirajte u stvarnom vremenu kada su vjerodajnice izdane, isporučene, opozvane ili pregledane. Radi svaka platforma koja govori REST i webhookove; Zapier i Make su najbrži.

Što možete automatizirati

Okidači (badges.ninja → vaši alati) — pokreću tijek rada kada:

• je vjerodajnica izdana
• je vjerodajnica isporučena (njezina e-poruka je poslana)
• je vjerodajnica opozvana
• je vjerodajnica pregledana prvi put

Radnje (vaši alati → badges.ninja):

• izdaj vjerodajnicu — dodijeli bedž primatelju

Preduvjeti

1. Stvorite API ključ na nadzornoj ploči pod API ključevi. Koristite ključ za čitanje-pisanje za radnje (izdavanje); ključ samo za čitanje dovoljan je samo za okidače. Pogledajte API ključevi.
2. To je sve — sve se odvija putem REST API-ja i webhookova.

Zapier

Nakon što je badges.ninja Zapier aplikacija povezana:

1. Povežite svoj račun — zalijepite svoj API ključ kada se to zatraži.
2. Odaberite okidač (npr. Credential Issued) ili radnju Issue Credential.
3. Mapirajte polja i uključite Zap.

Ispod haube okidači koriste Zapierov REST Hook model podržan Webhooks API-jem: Zapier se pretplaćuje putem POST /webhooks, a badges.ninja mu isporučuje događaje u stvarnom vremenu, pa nema kašnjenja zbog ispitivanja.

Make (Integromat) i prilagođene platforme

Aplikacija nije potrebna — povežite izravno:

1. Autentificirajte se zaglavljem X-Api-Key na svakom zahtjevu.
2. Pretplatite se na događaje registriranjem svog endpointa:

   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. Primajte potpisane isporuke na svom endpointu. Provjerite zaglavlje X-Bws-Signature — pogledajte Webhooks.
4. Izdajte vjerodajnice pozivom POST /awards — pogledajte Awards API.

Referenca

• Webhooks API — događaji, sadržaji, potpisi, ponovni pokušaji
• Awards API — izdavanje vjerodajnica
• API ključevi — ključevi i opsezi pristupa

Izvorni kôd Zapier aplikacije nalazi se u repozitoriju pod integrations/zapier/ i može se objaviti Zapier CLI-jem.