Integracijos (Zapier, Make ir daugiau)

Prijunkite badges.ninja prie įrankių, kuriuos jau naudojate — automatiškai išduokite kredencialus, kai kažkas įvyksta kitur, ir reaguokite realiu laiku, kai kredencialai išduodami, pristatomi, atšaukiami ar peržiūrimi. Veikia bet kuri platforma, kuri kalba REST ir webhooks; Zapier ir Make yra greičiausi.

Ką galite automatizuoti

Trigeriai (badges.ninja → jūsų įrankiai) — paleiskite darbo eigą, kai:

• kredencialas išduodamas
• kredencialas pristatomas (išsiunčiamas jo el. laiškas)
• kredencialas atšaukiamas
• kredencialas peržiūrimas pirmą kartą

Veiksmai (jūsų įrankiai → badges.ninja):

• išduoti kredencialą — apdovanoti gavėją ženkleliu

Būtinos sąlygos

1. Sukurkite API raktą skydelyje skiltyje API raktai. Naudokite skaitymo-rašymo raktą veiksmams (išdavimui); skaitymo tik raktas tinka vien trigeriams. Žr. API raktai.
2. Tai ir viskas — viskas veikia per REST API ir webhooks.

Zapier

Kai badges.ninja Zapier programa prijungta:

1. Prijunkite savo paskyrą — įklijuokite savo API raktą, kai bus paprašyta.
2. Pasirinkite trigerį (pvz., Credential Issued) arba veiksmą Issue Credential.
3. Priskirkite laukus ir įjunkite Zap.

Po gaubtu trigeriai naudoja Zapier REST Hook modelį, paremtą Webhooks API: Zapier užsiprenumeruoja per POST /webhooks, o badges.ninja realiu laiku pristato jam įvykius, todėl nėra apklausos delsos.

Make (Integromat) ir pasirinktinės platformos

Programa nereikalinga — sujunkite tiesiogiai:

1. Autentikuokitės su antrašte X-Api-Key kiekvienoje užklausoje.
2. Užsiprenumeruokite įvykius užregistruodami savo galinį tašką:

   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. Gaukite pasirašytus pristatymus savo galiniame taške. Patikrinkite antraštę X-Bws-Signature — žr. Webhooks.
4. Išduokite kredencialus iškviesdami POST /awards — žr. Awards API.

Nuorodos

• Webhooks API — įvykiai, turiniai, parašai, pakartojimai
• Awards API — kredencialų išdavimas
• API raktai — raktai ir prieigos sritys

Zapier programos šaltinis yra saugykloje po integrations/zapier/ ir gali būti įkeltas su Zapier CLI.