Integrationer (Zapier, Make med flera)

Anslut badges.ninja till verktygen du redan använder — utfärda intyg automatiskt när något händer någon annanstans, och reagera i realtid när intyg utfärdas, levereras, återkallas eller visas. Alla plattformar som talar REST och webhooks fungerar; Zapier och Make är snabbast.

Vad du kan automatisera

Utlösare (badges.ninja → dina verktyg) — starta ett arbetsflöde när:

• ett intyg utfärdas
• ett intyg levereras (dess mejl skickas)
• ett intyg återkallas
• ett intyg visas för första gången

Åtgärder (dina verktyg → badges.ninja):

• utfärda ett intyg — tilldela ett märke till en mottagare

Förutsättningar

1. Skapa en API-nyckel i instrumentpanelen under API-nycklar. Använd en läs- och skrivnyckel för åtgärder (utfärdande); en skrivskyddad nyckel räcker för enbart utlösare. Se API-nycklar.
2. Det var allt — allt körs över REST-API:et och webhooks.

Zapier

När badges.ninja Zapier-appen är ansluten:

1. Anslut ditt konto — klistra in din API-nyckel när du ombeds.
2. Välj en utlösare (t.ex. Credential Issued) eller åtgärden Issue Credential.
3. Mappa fält och slå på Zapen.

Under huven använder utlösare Zapiers REST Hook-modell som backas upp av Webhooks API: Zapier prenumererar via POST /webhooks och badges.ninja levererar händelser till den i realtid, så det finns ingen pollningsfördröjning.

Make (Integromat) och anpassade plattformar

Ingen app krävs — koppla ihop det direkt:

1. Autentisera med X-Api-Key-headern på varje begäran.
2. Prenumerera på händelser genom att registrera din slutpunkt:

   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. Ta emot signerade leveranser vid din slutpunkt. Verifiera X-Bws-Signature-headern — se Webhooks.
4. Utfärda intyg genom att anropa POST /awards — se Awards API.

Referens

• Webhooks API — händelser, nyttolaster, signaturer, omförsök
• Awards API — utfärda intyg
• API-nycklar — nycklar och åtkomstområden

Zapier-appens källkod finns i förvaret under integrations/zapier/ och kan pushas med Zapier CLI.