Integrationer (Zapier, Make og mere)

Forbind badges.ninja til de værktøjer, du allerede bruger — udsted beviser automatisk, når der sker noget andetsteds, og reagér i realtid, når beviser udstedes, leveres, tilbagekaldes eller vises. Enhver platform, der taler REST og webhooks, fungerer; Zapier og Make er de hurtigste.

Hvad du kan automatisere

Udløsere (badges.ninja → dine værktøjer) — start et workflow, når:

• et bevis udstedes
• et bevis leveres (dets e-mail sendes)
• et bevis tilbagekaldes
• et bevis vises for første gang

Handlinger (dine værktøjer → badges.ninja):

• udsted et bevis — tildel et mærke til en modtager

Forudsætninger

1. Opret en API-nøgle i dashboardet under API-nøgler. Brug en læse-skrive-nøgle til handlinger (udstedelse); en skrivebeskyttet nøgle er fin til kun udløsere. Se API-nøgler.
2. Det er det hele — alt kører over REST-API'et og webhooks.

Zapier

Når badges.ninja Zapier-appen er forbundet:

1. Forbind din konto — indsæt din API-nøgle, når du bliver bedt om det.
2. Vælg en udløser (f.eks. Credential Issued) eller handlingen Issue Credential.
3. Kortlæg felter, og slå Zap'en til.

Under motorhjelmen bruger udløsere Zapiers REST Hook-model understøttet af Webhooks API: Zapier abonnerer via POST /webhooks, og badges.ninja leverer hændelser til den i realtid, så der er ingen polling-forsinkelse.

Make (Integromat) og brugerdefinerede platforme

Ingen app påkrævet — forbind det direkte:

1. Godkend med X-Api-Key-headeren på hver forespørgsel.
2. Abonnér på hændelser ved at registrere dit 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. Modtag signerede leveringer ved dit endpoint. Verificér X-Bws-Signature-headeren — se Webhooks.
4. Udsted beviser ved at kalde POST /awards — se Awards API.

Reference

• Webhooks API — hændelser, payloads, signaturer, gentagelser
• Awards API — udstedelse af beviser
• API-nøgler — nøgler og adgangsområder

Zapier-appens kildekode ligger i repositoriet under integrations/zapier/ og kan pushes med Zapier CLI.