Integracje (Zapier, Make i inne)

Połącz badges.ninja z narzędziami, których już używasz — wystawiaj poświadczenia automatycznie, gdy coś się wydarzy w innym miejscu, i reaguj w czasie rzeczywistym, gdy poświadczenia są wystawiane, dostarczane, unieważniane lub wyświetlane. Działa każda platforma mówiąca w REST i webhookach; Zapier i Make są najszybsze.

Co możesz zautomatyzować

Wyzwalacze (badges.ninja → Twoje narzędzia) — uruchamiają przepływ pracy, gdy:

• poświadczenie jest wystawione
• poświadczenie jest dostarczone (jego e-mail jest wysłany)
• poświadczenie jest unieważnione
• poświadczenie jest wyświetlone po raz pierwszy

Akcje (Twoje narzędzia → badges.ninja):

• wystaw poświadczenie — przyznaj odznakę odbiorcy

Wymagania wstępne

1. Utwórz klucz API w panelu w sekcji API Keys. Użyj klucza z uprawnieniami do odczytu i zapisu do akcji (wystawiania); klucz tylko do odczytu wystarczy do samych wyzwalaczy. Zobacz Klucze API.
2. To wszystko — wszystko działa przez REST API i webhooki.

Zapier

Po połączeniu aplikacji Zapier badges.ninja:

1. Połącz swoje konto — wklej klucz API, gdy zostaniesz o to poproszony.
2. Wybierz wyzwalacz (np. Credential Issued) lub akcję Issue Credential.
3. Zmapuj pola i włącz Zapa.

Pod maską wyzwalacze korzystają z modelu REST Hook firmy Zapier opartego na Webhooks API: Zapier subskrybuje przez POST /webhooks, a badges.ninja dostarcza mu zdarzenia w czasie rzeczywistym, więc nie ma opóźnień związanych z odpytywaniem.

Make (Integromat) i platformy niestandardowe

Aplikacja nie jest wymagana — skonfiguruj bezpośrednio:

1. Uwierzytelnij się nagłówkiem X-Api-Key w każdym żądaniu.
2. Subskrybuj zdarzenia, rejestrując swój 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. Odbieraj podpisane dostarczenia na swoim endpoincie. Zweryfikuj nagłówek X-Bws-Signature — zobacz Webhooks.
4. Wystawiaj poświadczenia, wywołując POST /awards — zobacz Awards API.

Odniesienia

• Webhooks API — zdarzenia, ładunki, podpisy, ponowne próby
• Awards API — wystawianie poświadczeń
• Klucze API — klucze i zakresy dostępu

Kod źródłowy aplikacji Zapier znajduje się w repozytorium w katalogu integrations/zapier/ i można go wypchnąć za pomocą Zapier CLI.