Integrációk (Zapier, Make és több)

Kösd össze a badges.ninja-t a már használt eszközeiddel — állíts ki hitelesítő adatokat automatikusan, amikor valahol máshol történik valami, és reagálj valós időben, amikor hitelesítő adatokat állítanak ki, kézbesítenek, visszavonnak vagy megtekintenek. Bármely platform működik, amely beszéli a REST-et és a webhookokat; a Zapier és a Make a leggyorsabb.

Mit automatizálhatsz

Eseményindítók (badges.ninja → az eszközeid) — elindítanak egy munkafolyamatot, amikor:

• egy hitelesítő adatot kiállítanak
• egy hitelesítő adatot kézbesítenek (elküldik az e-mailjét)
• egy hitelesítő adatot visszavonnak
• egy hitelesítő adatot először megtekintenek

Műveletek (az eszközeid → badges.ninja):

• hitelesítő adat kiállítása — jelvény odaítélése egy címzettnek

Előfeltételek

1. Hozz létre egy API-kulcsot az irányítópulton az API-kulcsok alatt. Használj olvasási-írási kulcsot a műveletekhez (kiállítás); egy csak olvasható kulcs elegendő csak az eseményindítókhoz. Lásd: API-kulcsok.
2. Ennyi — minden a REST API-n és a webhookokon fut.

Zapier

Miután a badges.ninja Zapier-alkalmazás csatlakoztatva van:

1. Csatlakoztasd a fiókodat — illeszd be az API-kulcsodat, amikor a rendszer kéri.
2. Válassz egy eseményindítót (pl. Credential Issued) vagy az Issue Credential műveletet.
3. Rendeld hozzá a mezőket, és kapcsold be a Zapet.

A háttérben az eseményindítók a Zapier REST Hook modelljét használják, amelyet a Webhook API támogat: a Zapier a POST /webhooks végponton keresztül iratkozik fel, és a badges.ninja valós időben kézbesíti neki az eseményeket, így nincs lekérdezési késleltetés.

Make (Integromat) és egyéni platformok

Nincs szükség alkalmazásra — kösd össze közvetlenül:

1. Hitelesíts az X-Api-Key fejléccel minden kérésnél.
2. Iratkozz fel az eseményekre a végpontod regisztrálásával:

   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. Fogadd az aláírt kézbesítéseket a végpontodon. Ellenőrizd az X-Bws-Signature fejlécet — lásd: Webhookok.
4. Állíts ki hitelesítő adatokat a POST /awards meghívásával — lásd: Díjak API.

Referencia

• Webhook API — események, tartalmak, aláírások, újrapróbálkozások
• Díjak API — hitelesítő adatok kiállítása
• API-kulcsok — kulcsok és hozzáférési jogkörök

A Zapier-alkalmazás forráskódja a tárolóban az integrations/zapier/ alatt található, és a Zapier CLI-vel közzétehető.