Интеграције (Zapier, Make и више)

Повежите badges.ninja са алатима које већ користите — издајте уверења аутоматски када се негде другде нешто догоди и реагујте у реалном времену када су уверења издата, испоручена, опозвана или прегледана. Ради свака платформа која говори REST и webhook-ове; Zapier и Make су најбржи.

Шта можете да аутоматизујете

Окидачи (badges.ninja → ваши алати) — покрећу ток рада када:

• је уверење издато
• је уверење испоручено (његов имејл је послат)
• је уверење опозвано
• је уверење прегледано по први пут

Радње (ваши алати → badges.ninja):

• издај уверење — додели значку примаоцу

Предуслови

1. Креирајте API кључ на контролној табли под API кључеви. Користите кључ за читање-писање за радње (издавање); кључ само за читање је довољан само за окидаче. Погледајте API кључеви.
2. То је све — све се одвија преко REST API-ја и webhook-ова.

Zapier

Након што је badges.ninja Zapier апликација повезана:

1. Повежите свој налог — налепите свој API кључ када се то затражи.
2. Изаберите окидач (нпр. Credential Issued) или радњу Issue Credential.
3. Мапирајте поља и укључите Zap.

Испод хаубе окидачи користе Zapier-ов REST Hook модел подржан Webhooks API-јем: Zapier се претплаћује путем POST /webhooks, а badges.ninja му испоручује догађаје у реалном времену, тако да нема кашњења услед испитивања.

Make (Integromat) и прилагођене платформе

Апликација није потребна — повежите директно:

1. Аутентификујте се заглављем X-Api-Key при сваком захтеву.
2. Претплатите се на догађаје регистровањем своје крајње тачке:

   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. Примајте потписане испоруке на својој крајњој тачки. Проверите заглавље X-Bws-Signature — погледајте Webhooks.
4. Издајте уверења позивањем POST /awards — погледајте Awards API.

Референца

• Webhooks API — догађаји, садржаји, потписи, поновни покушаји
• Awards API — издавање уверења
• API кључеви — кључеви и опсези приступа

Изворни код Zapier апликације налази се у репозиторијуму под integrations/zapier/ и може се објавити помоћу Zapier CLI-ја.