Integraties (Zapier, Make & meer)

Verbind badges.ninja met de tools die je al gebruikt — geef automatisch credentials uit wanneer er ergens anders iets gebeurt, en reageer in realtime wanneer credentials worden uitgegeven, afgeleverd, ingetrokken of bekeken. Elk platform dat REST en webhooks spreekt werkt; Zapier en Make zijn het snelst.

Wat je kunt automatiseren

Triggers (badges.ninja → jouw tools) — start een workflow wanneer:

• een credential wordt uitgegeven
• een credential wordt afgeleverd (de e-mail wordt verzonden)
• een credential wordt ingetrokken
• een credential voor het eerst wordt bekeken

Acties (jouw tools → badges.ninja):

• een credential uitgeven — een badge aan een ontvanger toekennen

Vereisten

1. Maak een API-sleutel aan in het dashboard onder API-sleutels. Gebruik een lees-schrijfsleutel voor acties (uitgeven); een alleen-lezen sleutel volstaat voor alleen triggers. Zie API-sleutels.
2. Dat is alles — alles loopt via de REST API en webhooks.

Zapier

Zodra de badges.ninja Zapier-app is verbonden:

1. Verbind je account — plak je API-sleutel wanneer daarom wordt gevraagd.
2. Kies een trigger (bijv. Credential Issued) of de actie Issue Credential.
3. Wijs velden toe en zet de Zap aan.

Achter de schermen gebruiken triggers het REST Hook-model van Zapier, ondersteund door de Webhooks-API: Zapier abonneert zich via POST /webhooks en badges.ninja levert er gebeurtenissen in realtime aan, zonder pollvertraging.

Make (Integromat) & aangepaste platforms

Geen app nodig — koppel het rechtstreeks:

1. Authenticeer met de X-Api-Key-header bij elk verzoek.
2. Abonneer je op gebeurtenissen door je endpoint te registreren:

   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. Ontvang ondertekende afleveringen op je endpoint. Verifieer de X-Bws-Signature-header — zie Webhooks.
4. Geef credentials uit door POST /awards aan te roepen — zie Awards-API.

Referentie

• Webhooks-API — gebeurtenissen, payloads, handtekeningen, nieuwe pogingen
• Awards-API — credentials uitgeven
• API-sleutels — sleutels en toegangsscopes

De broncode van de Zapier-app staat in de repository onder integrations/zapier/ en kan met de Zapier-CLI worden gepubliceerd.