Интеграции (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.