ইন্টিগ্রেশন (Zapier, Make ও আরও)

আপনি ইতিমধ্যে ব্যবহার করেন এমন টুলগুলির সাথে badges.ninja সংযুক্ত করুন — অন্য কোথাও কিছু ঘটলে স্বয়ংক্রিয়ভাবে ক্রেডেনশিয়াল ইস্যু করুন, এবং ক্রেডেনশিয়াল ইস্যু, ডেলিভার, রিভোক, বা ভিউ হলে রিয়েল টাইমে প্রতিক্রিয়া জানান। REST ও webhook বলতে পারে এমন যেকোনো প্ল্যাটফর্ম কাজ করে; Zapier ও Make সবচেয়ে দ্রুত।

আপনি কী স্বয়ংক্রিয় করতে পারেন

Triggers (badges.ninja → আপনার টুল) — একটি ওয়ার্কফ্লো ফায়ার করুন যখন:

• একটি ক্রেডেনশিয়াল ইস্যু করা হয়
• একটি ক্রেডেনশিয়াল ডেলিভার করা হয় (এর ইমেইল পাঠানো হয়)
• একটি ক্রেডেনশিয়াল রিভোক করা হয়
• একটি ক্রেডেনশিয়াল প্রথমবারের জন্য ভিউ করা হয়

Actions (আপনার টুল → badges.ninja):

• একটি ক্রেডেনশিয়াল ইস্যু করুন — একজন প্রাপককে একটি ব্যাজ award করুন

পূর্বশর্ত

1. API Keys এর অধীনে ড্যাশবোর্ডে একটি API কী তৈরি করুন। অ্যাকশনের (ইস্যুয়িং) জন্য একটি read-write কী ব্যবহার করুন; শুধুমাত্র trigger-এর জন্য একটি read-only কী যথেষ্ট। দেখুন API কী।
2. এটুকুই — সবকিছু REST API ও webhook-এর উপর চলে।

Zapier

একবার badges.ninja Zapier অ্যাপ সংযুক্ত হলে:

1. আপনার অ্যাকাউন্ট সংযুক্ত করুন — অনুরোধ করা হলে আপনার API কী পেস্ট করুন।
2. একটি trigger বেছে নিন (যেমন Credential Issued) বা Issue Credential অ্যাকশন।
3. ফিল্ড ম্যাপ করুন এবং Zap চালু করুন।

আড়ালে, trigger-গুলি 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 দিয়ে পুশ করা যায়।