Integrazioni (Zapier, Make e altro)

Collega badges.ninja agli strumenti che usi già — rilascia credenziali automaticamente quando accade qualcosa altrove, e reagisci in tempo reale quando le credenziali vengono rilasciate, consegnate, revocate o visualizzate. Funziona qualsiasi piattaforma che parli REST e webhook; Zapier e Make sono i più rapidi.

Cosa puoi automatizzare

Trigger (badges.ninja → i tuoi strumenti) — avvia un workflow quando:

• una credenziale viene rilasciata
• una credenziale viene consegnata (viene inviata la sua email)
• una credenziale viene revocata
• una credenziale viene visualizzata per la prima volta

Azioni (i tuoi strumenti → badges.ninja):

• rilasciare una credenziale — assegnare un badge a un destinatario

Prerequisiti

1. Crea una chiave API nella dashboard sotto Chiavi API. Usa una chiave in lettura-scrittura per le azioni (rilascio); una chiave in sola lettura va bene per i soli trigger. Vedi Chiavi API.
2. Tutto qui — tutto passa attraverso l'API REST e i webhook.

Zapier

Una volta connessa l'app Zapier di badges.ninja:

1. Connetti il tuo account — incolla la tua chiave API quando richiesto.
2. Scegli un trigger (ad es. Credential Issued) o l'azione Issue Credential.
3. Mappa i campi e attiva lo Zap.

Dietro le quinte, i trigger usano il modello REST Hook di Zapier, basato sull'API Webhook: Zapier si abbona tramite POST /webhooks e badges.ninja gli consegna gli eventi in tempo reale, senza ritardi di polling.

Make (Integromat) e piattaforme personalizzate

Nessuna app richiesta — collegalo direttamente:

1. Autenticati con l'header X-Api-Key su ogni richiesta.
2. Abbonati agli eventi registrando il tuo endpoint:

   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. Ricevi le consegne firmate al tuo endpoint. Verifica l'header X-Bws-Signature — vedi Webhooks.
4. Rilascia credenziali chiamando POST /awards — vedi API Award.

Riferimenti

• API Webhook — eventi, payload, firme, nuovi tentativi
• API Award — rilascio delle credenziali
• Chiavi API — chiavi e scope di accesso

Il codice sorgente dell'app Zapier si trova nel repository sotto integrations/zapier/ e può essere pubblicato con la CLI Zapier.