Integrace (Zapier, Make a další)

Propojte badges.ninja s nástroji, které již používáte — vydávejte přihlašovací údaje automaticky, když se něco stane jinde, a reagujte v reálném čase, když jsou přihlašovací údaje vydány, doručeny, odvolány nebo zobrazeny. Funguje jakákoli platforma, která mluví REST a webhooky; Zapier a Make jsou nejrychlejší.

Co můžete automatizovat

Spouštěče (badges.ninja → vaše nástroje) — spustí pracovní postup, když:

• přihlašovací údaj je vydán
• přihlašovací údaj je doručen (jeho e-mail je odeslán)
• přihlašovací údaj je odvolán
• přihlašovací údaj je zobrazen poprvé

Akce (vaše nástroje → badges.ninja):

• vydat přihlašovací údaj — udělit odznak příjemci

Předpoklady

1. Vytvořte klíč API v panelu v sekci API Keys. Pro akce (vydávání) použijte klíč pro čtení i zápis; klíč pouze pro čtení stačí jen pro spouštěče. Viz Klíče API.
2. To je vše — vše běží přes REST API a webhooky.

Zapier

Jakmile je aplikace Zapier badges.ninja připojena:

1. Připojte svůj účet — vložte klíč API, když k tomu budete vyzváni.
2. Vyberte spouštěč (např. Credential Issued) nebo akci Issue Credential.
3. Namapujte pole a zapněte Zap.

Pod kapotou spouštěče používají model REST Hook společnosti Zapier založený na Webhooks API: Zapier se přihlásí přes POST /webhooks a badges.ninja mu doručuje události v reálném čase, takže nedochází k prodlevě dotazování.

Make (Integromat) a vlastní platformy

Aplikace není potřeba — nastavte to přímo:

1. Autentizujte se hlavičkou X-Api-Key v každém požadavku.
2. Přihlaste se k odběru událostí registrací svého endpointu:

   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. Přijímejte podepsaná doručení na svém endpointu. Ověřte hlavičku X-Bws-Signature — viz Webhooks.
4. Vydávejte přihlašovací údaje voláním POST /awards — viz Awards API.

Reference

• Webhooks API — události, datové části, podpisy, opakování
• Awards API — vydávání přihlašovacích údajů
• Klíče API — klíče a oprávnění

Zdrojový kód aplikace Zapier se nachází v repozitáři v adresáři integrations/zapier/ a lze jej odeslat pomocí Zapier CLI.