Integrationen (Zapier, Make & mehr)

Verbinde badges.ninja mit den Tools, die du bereits nutzt — stelle Credentials automatisch aus, wenn anderswo etwas passiert, und reagiere in Echtzeit, wenn Credentials ausgestellt, zugestellt, widerrufen oder angesehen werden. Jede Plattform, die REST und Webhooks spricht, funktioniert; Zapier und Make sind am schnellsten.

Was du automatisieren kannst

Trigger (badges.ninja → deine Tools) — löse einen Workflow aus, wenn:

• ein Credential ausgestellt wird
• ein Credential zugestellt wird (seine E-Mail versendet wird)
• ein Credential widerrufen wird
• ein Credential zum ersten Mal angesehen wird

Aktionen (deine Tools → badges.ninja):

• ein Credential ausstellen — einem Empfänger einen Badge verleihen

Voraussetzungen

1. Erstelle im Dashboard unter API-Schlüssel einen API-Schlüssel. Verwende einen Lese-Schreib-Schlüssel für Aktionen (Ausstellen); ein reiner Leseschlüssel genügt für reine Trigger. Siehe API-Schlüssel.
2. Das war's — alles läuft über die REST-API und Webhooks.

Zapier

Sobald die badges.ninja-Zapier-App verbunden ist:

1. Verbinde dein Konto — füge deinen API-Schlüssel ein, wenn du dazu aufgefordert wirst.
2. Wähle einen Trigger (z. B. Credential Issued) oder die Aktion Issue Credential.
3. Ordne die Felder zu und aktiviere den Zap.

Unter der Haube nutzen Trigger das REST-Hook-Modell von Zapier, gestützt auf die Webhooks-API: Zapier abonniert über POST /webhooks, und badges.ninja stellt die Ereignisse in Echtzeit zu, sodass es keine Abfrageverzögerung gibt.

Make (Integromat) & eigene Plattformen

Keine App erforderlich — richte es direkt ein:

1. Authentifiziere dich mit dem X-Api-Key-Header bei jeder Anfrage.
2. Abonniere Ereignisse, indem du deinen Endpunkt registrierst:

   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. Empfange signierte Zustellungen an deinem Endpunkt. Verifiziere den X-Bws-Signature-Header — siehe Webhooks.
4. Stelle Credentials aus, indem du POST /awards aufrufst — siehe Awards-API.

Referenz

• Webhooks-API — Ereignisse, Payloads, Signaturen, Wiederholungen
• Awards-API — Ausstellen von Credentials
• API-Schlüssel — Schlüssel und Zugriffs-Scopes

Der Quellcode der Zapier-App liegt im Repository unter integrations/zapier/ und kann mit der Zapier-CLI veröffentlicht werden.