Entegrasyonlar (Zapier, Make ve daha fazlası)

badges.ninja'yı zaten kullandığınız araçlara bağlayın — başka bir yerde bir şey olduğunda kimlik bilgilerini otomatik olarak verin ve kimlik bilgileri verildiğinde, teslim edildiğinde, iptal edildiğinde veya görüntülendiğinde gerçek zamanlı olarak tepki verin. REST ve webhooks konuşan her platform çalışır; Zapier ve Make en hızlı olanlardır.

Neleri Otomatikleştirebilirsiniz

Tetikleyiciler (badges.ninja → araçlarınız) — şu durumlarda bir iş akışını başlatın:

• bir kimlik bilgisi verildiğinde
• bir kimlik bilgisi teslim edildiğinde (e-postası gönderildiğinde)
• bir kimlik bilgisi iptal edildiğinde
• bir kimlik bilgisi ilk kez görüntülendiğinde

Eylemler (araçlarınız → badges.ninja):

• bir kimlik bilgisi verin — bir alıcıya bir rozet verin

Ön Koşullar

1. Kontrol panelinde API Keys altında bir API anahtarı oluşturun. Eylemler (verme) için okuma-yazma anahtarı kullanın; yalnızca tetikleyiciler için salt okunur bir anahtar yeterlidir. Bkz. API Anahtarları.
2. Hepsi bu kadar — her şey REST API ve webhooks üzerinden çalışır.

Zapier

badges.ninja Zapier uygulaması bağlandıktan sonra:

1. Hesabınızı bağlayın — istendiğinde API anahtarınızı yapıştırın.
2. Bir tetikleyici (ör. Credential Issued) veya Issue Credential eylemini seçin.
3. Alanları eşleştirin ve Zap'ı açın.

Arka planda tetikleyiciler, Webhooks API tarafından desteklenen Zapier'in REST Hook modelini kullanır: Zapier POST /webhooks aracılığıyla abone olur ve badges.ninja olayları ona gerçek zamanlı olarak teslim eder, bu nedenle yoklama gecikmesi yoktur.

Make (Integromat) ve Özel Platformlar

Uygulama gerekmez — doğrudan bağlayın:

1. Her istekte X-Api-Key başlığıyla kimlik doğrulaması yapın.
2. Uç noktanızı kaydederek olaylara abone olun:

   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. Uç noktanızda imzalı teslimatları alın. X-Bws-Signature başlığını doğrulayın — bkz. Webhooks.
4. POST /awards çağırarak kimlik bilgileri verin — bkz. Awards API.

Referans

• Webhooks API — olaylar, yükler, imzalar, yeniden denemeler
• Awards API — kimlik bilgileri verme
• API Anahtarları — anahtarlar ve erişim kapsamları

Zapier uygulama kaynağı, depoda integrations/zapier/ altında bulunur ve Zapier CLI ile gönderilebilir.