एकीकरण (Zapier, Make और अधिक)

badges.ninja को उन उपकरणों से कनेक्ट करें जिनका आप पहले से उपयोग करते हैं — जब कहीं और कुछ घटित होता है तो स्वचालित रूप से क्रेडेंशियल जारी करें, और जब क्रेडेंशियल जारी, वितरित, निरस्त, या देखे जाते हैं तो वास्तविक समय में प्रतिक्रिया दें। कोई भी प्लेटफ़ॉर्म जो REST और webhooks बोलता है काम करता है; Zapier और Make सबसे तेज़ हैं।

आप क्या स्वचालित कर सकते हैं

Triggers (badges.ninja → आपके उपकरण) — जब निम्न हो तो एक वर्कफ़्लो फायर करें:

• एक क्रेडेंशियल जारी किया जाता है
• एक क्रेडेंशियल वितरित किया जाता है (इसका ईमेल भेजा जाता है)
• एक क्रेडेंशियल निरस्त किया जाता है
• एक क्रेडेंशियल पहली बार देखा जाता है

Actions (आपके उपकरण → badges.ninja):

• एक क्रेडेंशियल जारी करें — किसी प्राप्तकर्ता को एक बैज प्रदान करें

पूर्वापेक्षाएँ

1. डैशबोर्ड में API Keys के अंतर्गत एक API कुंजी बनाएं। एक्शन (जारी करने) के लिए एक रीड-राइट कुंजी का उपयोग करें; केवल ट्रिगर के लिए एक रीड-ओनली कुंजी ठीक है। API कुंजियाँ देखें।
2. बस इतना ही — सब कुछ REST API और webhooks पर चलता है।

Zapier

एक बार badges.ninja Zapier ऐप कनेक्ट हो जाने के बाद:

1. अपना खाता कनेक्ट करें — संकेत मिलने पर अपनी API कुंजी पेस्ट करें।
2. एक ट्रिगर चुनें (उदा. Credential Issued) या Issue Credential एक्शन।
3. फ़ील्ड मैप करें और Zap चालू करें।

पर्दे के पीछे, ट्रिगर Webhooks API द्वारा समर्थित Zapier के REST Hook मॉडल का उपयोग करते हैं: Zapier POST /webhooks के माध्यम से सब्सक्राइब करता है और badges.ninja वास्तविक समय में उसे इवेंट वितरित करता है, इसलिए कोई पोलिंग विलंब नहीं होता।

Make (Integromat) और कस्टम प्लेटफ़ॉर्म

किसी ऐप की आवश्यकता नहीं — इसे सीधे वायर करें:

1. प्रत्येक अनुरोध पर X-Api-Key हेडर के साथ प्रमाणित करें।
2. अपना एंडपॉइंट पंजीकृत करके इवेंट पर सब्सक्राइब करें:

   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. अपने एंडपॉइंट पर हस्ताक्षरित वितरण प्राप्त करें। X-Bws-Signature हेडर सत्यापित करें — Webhooks देखें।
4. POST /awards कॉल करके क्रेडेंशियल जारी करें — Awards API देखें।

संदर्भ

• Webhooks API — इवेंट, पेलोड, हस्ताक्षर, पुनः प्रयास
• Awards API — क्रेडेंशियल जारी करना
• API कुंजियाँ — कुंजियाँ और एक्सेस स्कोप

Zapier ऐप स्रोत रिपॉजिटरी में integrations/zapier/ के अंतर्गत रहता है और इसे Zapier CLI के साथ पुश किया जा सकता है।