Інтеграції (Zapier, Make та інші)

Підключіть badges.ninja до інструментів, якими ви вже користуєтеся, — видавайте облікові дані автоматично, коли щось відбувається в іншому місці, і реагуйте в реальному часі, коли облікові дані видаються, доставляються, відкликаються чи переглядаються. Працює будь-яка платформа, що розмовляє REST і вебхуками; Zapier і Make — найшвидші.

Що можна автоматизувати

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

• облікові дані видано
• облікові дані доставлено (їхній лист надіслано)
• облікові дані відкликано
• облікові дані переглянуто вперше

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

• видати облікові дані — нагородити отримувача значком

Передумови

1. Створіть ключ API у панелі в розділі API Keys. Використовуйте ключ із доступом на читання-запис для дій (видачі); ключ лише для читання підходить лише для тригерів. Див. Ключі API.
2. Ось і все — усе працює через REST API та вебхуки.

Zapier

Після підключення застосунку badges.ninja для Zapier:

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.