Интеграции (Zapier, Make и други)

Свържете badges.ninja с инструментите, които вече използвате — издавайте удостоверения автоматично, когато нещо се случи другаде, и реагирайте в реално време, когато удостоверения бъдат издадени, доставени, отменени или прегледани. Работи всяка платформа, която говори REST и webhook-ове; Zapier и Make са най-бързите.

Какво можете да автоматизирате

Тригери (badges.ninja → вашите инструменти) — задействат работен процес, когато:

• удостоверение е издадено
• удостоверение е доставено (имейлът му е изпратен)
• удостоверение е отменено
• удостоверение е прегледано за първи път

Действия (вашите инструменти → badges.ninja):

• издаване на удостоверение — присъждане на значка на получател

Предпоставки

1. Създайте API ключ в таблото под API ключове. Използвайте ключ за четене-запис за действия (издаване); ключ само за четене е достатъчен само за тригери. Вижте API ключове.
2. Това е всичко — всичко работи през REST API и webhook-ове.

Zapier

След като приложението Zapier на badges.ninja е свързано:

1. Свържете акаунта си — поставете вашия API ключ, когато бъдете подканени.
2. Изберете тригер (напр. Credential Issued) или действието Issue Credential.
3. Съпоставете полетата и включете Zap-а.

Под капака тригерите използват модела REST Hook на Zapier, поддържан от 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.