Integrasjoner (Zapier, Make med mer)

Koble badges.ninja til verktøyene du allerede bruker — utsted bevis automatisk når det skjer noe et annet sted, og reager i sanntid når bevis utstedes, leveres, tilbakekalles eller vises. Enhver plattform som snakker REST og webhooks fungerer; Zapier og Make er de raskeste.

Hva du kan automatisere

Utløsere (badges.ninja → verktøyene dine) — start en arbeidsflyt når:

• et bevis utstedes
• et bevis leveres (e-posten sendes)
• et bevis tilbakekalles
• et bevis vises for første gang

Handlinger (verktøyene dine → badges.ninja):

• utsted et bevis — tildel et merke til en mottaker

Forutsetninger

1. Opprett en API-nøkkel i dashbordet under API-nøkler. Bruk en lese-skrive-nøkkel for handlinger (utstedelse); en skrivebeskyttet nøkkel er tilstrekkelig for kun utløsere. Se API-nøkler.
2. Det er alt — alt kjører over REST-API-et og webhooks.

Zapier

Når badges.ninja Zapier-appen er koblet til:

1. Koble til kontoen din — lim inn API-nøkkelen din når du blir bedt om det.
2. Velg en utløser (f.eks. Credential Issued) eller handlingen Issue Credential.
3. Tilordne felter, og slå på Zap-en.

Under panseret bruker utløsere Zapiers REST Hook-modell støttet av Webhooks API: Zapier abonnerer via POST /webhooks, og badges.ninja leverer hendelser til den i sanntid, så det er ingen polling-forsinkelse.

Make (Integromat) og egendefinerte plattformer

Ingen app kreves — koble det opp direkte:

1. Autentiser med X-Api-Key-headeren på hver forespørsel.
2. Abonner på hendelser ved å registrere endepunktet ditt:

   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. Motta signerte leveranser ved endepunktet ditt. Verifiser X-Bws-Signature-headeren — se Webhooks.
4. Utsted bevis ved å kalle POST /awards — se Awards API.

Referanse

• Webhooks API — hendelser, nyttelaster, signaturer, nye forsøk
• Awards API — utstedelse av bevis
• API-nøkler — nøkler og tilgangsområder

Kildekoden til Zapier-appen ligger i repositoriet under integrations/zapier/ og kan pushes med Zapier CLI.