Integrācijas (Zapier, Make un citas)

Savienojiet badges.ninja ar rīkiem, kurus jau izmantojat — automātiski izsniedziet akreditācijas datus, kad kaut kur citur kaut kas notiek, un reaģējiet reāllaikā, kad akreditācijas dati tiek izsniegti, piegādāti, atsaukti vai apskatīti. Darbojas jebkura platforma, kas saprot REST un webhooks; Zapier un Make ir ātrākie.

Ko varat automatizēt

Trigeri (badges.ninja → jūsu rīki) — palaidiet darbplūsmu, kad:

• akreditācijas dati tiek izsniegti
• akreditācijas dati tiek piegādāti (tiek nosūtīts to e-pasts)
• akreditācijas dati tiek atsaukti
• akreditācijas dati tiek apskatīti pirmo reizi

Darbības (jūsu rīki → badges.ninja):

• izsniegt akreditācijas datus — piešķirt nozīmi saņēmējam

Priekšnosacījumi

1. Izveidojiet API atslēgu vadības panelī sadaļā API Keys. Darbībām (izsniegšanai) izmantojiet lasīšanas-rakstīšanas atslēgu; tikai trigeriem pietiek ar lasīšanas atslēgu. Skatiet API atslēgas.
2. Tas arī viss — viss darbojas caur REST API un webhooks.

Zapier

Kad badges.ninja Zapier lietotne ir savienota:

1. Savienojiet savu kontu — ielīmējiet savu API atslēgu, kad tiek prasīts.
2. Izvēlieties trigeri (piem., Credential Issued) vai darbību Issue Credential.
3. Kartējiet laukus un ieslēdziet Zap.

Zem pārsega trigeri izmanto Zapier REST Hook modeli, kas balstīts uz Webhooks API: Zapier abonē caur POST /webhooks, un badges.ninja piegādā tam notikumus reāllaikā, tāpēc nav aptaujāšanas aizkaves.

Make (Integromat) un pielāgotas platformas

Nav nepieciešama lietotne — savienojiet to tieši:

1. Autentificējieties ar galveni X-Api-Key katrā pieprasījumā.
2. Abonējiet notikumus, reģistrējot savu galapunktu:

   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. Saņemiet parakstītas piegādes savā galapunktā. Pārbaudiet galveni X-Bws-Signature — skatiet Webhooks.
4. Izsniedziet akreditācijas datus, izsaucot POST /awards — skatiet Awards API.

Uzziņas

• Webhooks API — notikumi, slodzes, paraksti, atkārtoti mēģinājumi
• Awards API — akreditācijas datu izsniegšana
• API atslēgas — atslēgas un piekļuves tvērumi

Zapier lietotnes pirmkods atrodas repozitorijā zem integrations/zapier/ un to var nosūtīt ar Zapier CLI.