การผสานรวม (Zapier, Make และอื่นๆ)

เชื่อมต่อ badges.ninja เข้ากับเครื่องมือที่คุณใช้อยู่แล้ว — ออกข้อมูลรับรองโดยอัตโนมัติเมื่อมีเหตุการณ์เกิดขึ้นที่อื่น และตอบสนองแบบเรียลไทม์เมื่อมีการออก การนำส่ง การเพิกถอน หรือการเข้าชมข้อมูลรับรอง แพลตฟอร์มใดก็ตามที่สื่อสารด้วย REST และ webhook ได้ใช้งานได้ โดย Zapier และ Make เป็นวิธีที่รวดเร็วที่สุด

สิ่งที่คุณสามารถทำให้เป็นอัตโนมัติได้

ทริกเกอร์ (Triggers) (badges.ninja → เครื่องมือของคุณ) — เริ่มเวิร์กโฟลว์เมื่อ:

• มีการออกข้อมูลรับรอง
• มีการนำส่งข้อมูลรับรอง (ส่งอีเมลของมันแล้ว)
• มีการเพิกถอนข้อมูลรับรอง
• มีการเข้าชมข้อมูลรับรองเป็นครั้งแรก

แอ็กชัน (Actions) (เครื่องมือของคุณ → badges.ninja):

• ออกข้อมูลรับรอง — มอบเหรียญตราให้แก่ผู้รับ

ข้อกำหนดเบื้องต้น

1. สร้าง คีย์ API ในแดชบอร์ดที่ API Keys ใช้คีย์แบบอ่าน-เขียนสำหรับแอ็กชัน (การออก) ส่วนคีย์แบบอ่านอย่างเดียวเพียงพอสำหรับทริกเกอร์เท่านั้น ดู คีย์ API
2. เท่านี้เอง — ทุกอย่างทำงานผ่าน REST API และ webhook

Zapier

เมื่อเชื่อมต่อแอป Zapier ของ badges.ninja แล้ว:

1. เชื่อมต่อบัญชีของคุณ — วางคีย์ API ของคุณเมื่อได้รับแจ้ง
2. เลือกทริกเกอร์ (เช่น Credential Issued) หรือแอ็กชัน Issue Credential
3. จับคู่ฟิลด์แล้วเปิดใช้งาน Zap

เบื้องหลัง ทริกเกอร์ใช้โมเดล REST Hook ของ Zapier ที่รองรับด้วย Webhooks API: Zapier สมัครรับผ่าน POST /webhooks และ badges.ninja นำส่งเหตุการณ์ไปยังมันแบบเรียลไทม์ จึงไม่มีความล่าช้าจากการ polling

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/ และสามารถ push ได้ด้วย Zapier CLI