Integrări (Zapier, Make și altele)

Conectează badges.ninja la instrumentele pe care le folosești deja — emite credențiale automat când se întâmplă ceva în altă parte și reacționează în timp real când credențialele sunt emise, livrate, revocate sau vizualizate. Orice platformă care vorbește REST și webhook-uri funcționează; Zapier și Make sunt cele mai rapide.

Ce poți automatiza

Declanșatoare (badges.ninja → instrumentele tale) — pornesc un flux de lucru când:

• o credențială este emisă
• o credențială este livrată (e-mailul său este trimis)
• o credențială este revocată
• o credențială este vizualizată pentru prima dată

Acțiuni (instrumentele tale → badges.ninja):

• emite o credențială — acordă o insignă unui destinatar

Cerințe prealabile

1. Creează o cheie API în panou, la Chei API. Folosește o cheie de citire-scriere pentru acțiuni (emitere); o cheie doar-citire este suficientă doar pentru declanșatoare. Vezi Chei API.
2. Atât — totul rulează peste REST API și webhook-uri.

Zapier

Odată ce aplicația Zapier badges.ninja este conectată:

1. Conectează-ți contul — lipește cheia API când ți se cere.
2. Alege un declanșator (de ex. Credential Issued) sau acțiunea Issue Credential.
3. Mapează câmpurile și activează Zap-ul.

În culise, declanșatoarele folosesc modelul REST Hook al Zapier susținut de API-ul Webhooks: Zapier se abonează prin POST /webhooks, iar badges.ninja îi livrează evenimentele în timp real, deci nu există întârziere de interogare.

Make (Integromat) și platforme personalizate

Nu este necesară nicio aplicație — conectează-l direct:

1. Autentifică-te cu antetul X-Api-Key la fiecare solicitare.
2. Abonează-te la evenimente înregistrându-ți endpoint-ul:

   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. Primește livrări semnate la endpoint-ul tău. Verifică antetul X-Bws-Signature — vezi Webhooks.
4. Emite credențiale apelând POST /awards — vezi API Distincții.

Referință

• API Webhooks — evenimente, conținuturi, semnături, reîncercări
• API Distincții — emiterea credențialelor
• Chei API — chei și domenii de acces

Codul sursă al aplicației Zapier se află în repozitoriu sub integrations/zapier/ și poate fi împins cu Zapier CLI.