Integraatiot (Zapier, Make ja muut)

Yhdistä badges.ninja työkaluihin, joita jo käytät — myönnä todistuksia automaattisesti, kun muualla tapahtuu jotain, ja reagoi reaaliajassa, kun todistuksia myönnetään, toimitetaan, peruutetaan tai katsotaan. Mikä tahansa alusta, joka puhuu RESTiä ja webhookeja, toimii; Zapier ja Make ovat nopeimmat.

Mitä voit automatisoida

Laukaisimet (badges.ninja → työkalusi) — käynnistä työnkulku, kun:

• todistus myönnetään
• todistus toimitetaan (sen sähköposti lähetetään)
• todistus peruutetaan
• todistus katsotaan ensimmäistä kertaa

Toiminnot (työkalusi → badges.ninja):

• myönnä todistus — myönnä merkki vastaanottajalle

Edellytykset

1. Luo API-avain koontinäytöllä kohdassa API-avaimet. Käytä luku-kirjoitus-avainta toimintoihin (myöntämiseen); vain luku -avain riittää pelkkiin laukaisimiin. Katso API-avaimet.
2. Siinä kaikki — kaikki toimii REST-API:n ja webhookien kautta.

Zapier

Kun badges.ninja Zapier -sovellus on yhdistetty:

1. Yhdistä tilisi — liitä API-avaimesi pyydettäessä.
2. Valitse laukaisin (esim. Credential Issued) tai Issue Credential -toiminto.
3. Kartoita kentät ja ota Zap käyttöön.

Konepellin alla laukaisimet käyttävät Zapierin REST Hook -mallia, jonka taustalla on Webhookien API: Zapier tilaa POST /webhooks -pyynnön kautta, ja badges.ninja toimittaa tapahtumat sille reaaliajassa, joten kyselyviivettä ei ole.

Make (Integromat) ja mukautetut alustat

Sovellusta ei tarvita — kytke se suoraan:

1. Todenna X-Api-Key-otsikolla jokaisessa pyynnössä.
2. Tilaa tapahtumat rekisteröimällä päätepisteesi:

   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. Vastaanota allekirjoitettuja toimituksia päätepisteessäsi. Vahvista X-Bws-Signature-otsikko — katso Webhookit.
4. Myönnä todistuksia kutsumalla POST /awards — katso Myöntämisten API.

Viite

• Webhookien API — tapahtumat, hyötykuormat, allekirjoitukset, uudelleenyritykset
• Myöntämisten API — todistusten myöntäminen
• API-avaimet — avaimet ja käyttöoikeusalueet

Zapier-sovelluksen lähdekoodi sijaitsee repositoriossa kohdassa integrations/zapier/, ja se voidaan pushata Zapier CLI:llä.